@podx/mcp-server

v2.0.2

Published

3 months ago

🤖 Model Context Protocol server for PODx - AI-powered bot detection and crypto analysis tools

0High
0Medium
0Low

mcp model-context-protocol bot-detection crypto-analysis twitter-scraping podx ai-tools llm-integration claude-computer-use automation

PODx MCP Server

A Model Context Protocol (MCP) server that provides advanced bot detection, crypto analysis, and Twitter scraping capabilities for AI assistants like Claude.

Features

🤖 Bot Detection Tools

Advanced Bot Analysis: Analyze Twitter accounts for bot-like behavior patterns
Network Risk Assessment: Detect coordinated bot networks and suspicious engagement
Behavioral Pattern Recognition: Identify artificial posting patterns and interaction anomalies

💰 Crypto Analysis Tools

Token Shilling Detection: Identify accounts promoting specific cryptocurrencies
Pump & Dump Schemes: Detect coordinated promotional campaigns
Trading Signal Analysis: Extract and analyze crypto trading signals from social media

🔍 Data Scraping Tools

Twitter Data Extraction: Scrape tweets, profiles, and engagement data
Hashtag Monitoring: Track hashtag usage and trending topics
Search Query Analysis: Analyze search results and social media discussions

📊 Resources & Prompts

Tweet Analysis Resources: Structured analysis of tweet content and metadata
User Profile Resources: Comprehensive user profile analysis
Analysis Prompts: Pre-built prompts for various analysis scenarios

Installation

# Install via npm
npm install @podx/mcp-server

# Or install via bun
bun add @podx/mcp-server

Usage

As a Standalone Server

# Start the MCP server
podx-mcp-server

# Or run directly with node
node ./bin/server.js

Note: The MCP server uses stdio transport (stdin/stdout) and does not bind to a network port. This ensures no conflicts with other services like the PODx API server (port 3000).

Integration with Claude Desktop

Add to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "podx": {
      "command": "podx-mcp-server",
      "args": [],
      "env": {}
    }
  }
}

Programmatic Usage

import { PodxMcpServer } from '@podx/mcp-server';

const server = new PodxMcpServer();
await server.start();

Available Tools

Bot Detection

bot-detection: Analyze accounts for bot-like behavior
Input: username, analysis depth, tweet limit
Output: Bot probability score, suspicious patterns, network analysis

Token Shilling Analysis

token-shilling: Detect cryptocurrency promotional behavior
Input: username, token symbol, analysis type
Output: Shilling probability, promotional patterns, coordination indicators

Crypto Analysis

crypto-analysis: Extract trading signals and market sentiment
Input: username/hashtag/search query, timeframe
Output: Trading signals, sentiment analysis, market insights

Data Scraping

scraping: Extract Twitter data with advanced filtering
Input: target (user/hashtag/search), filters, limits
Output: Structured tweet data, user profiles, engagement metrics

Resources

Tweet Analysis Resource

URI: podx://tweet-analysis/{username}
Provides: Comprehensive tweet analysis including sentiment, patterns, and metadata

User Profile Resource

URI: podx://user-profile/{username}
Provides: Detailed user profile analysis including behavior patterns and network connections

Environment Variables

Required: Twitter Authentication

# Required: Twitter account credentials
XSERVE_USERNAME="your_twitter_username"
XSERVE_PASSWORD="your_twitter_password"
XSERVE_EMAIL="[email protected]"  # Optional, for account recovery

⚠️ Important: The MCP server requires valid Twitter credentials to function. It uses the agent-twitter-client library with username/password authentication (not OAuth API tokens).

Optional: Configuration

# Optional: Configure API limits and timeouts
PODX_MAX_TWEETS=1000
PODX_TIMEOUT_MS=30000
PODX_RATE_LIMIT_DELAY=1000

# Optional: Enable debug logging
PODX_DEBUG=true

Development

# Clone and install dependencies
git clone https://github.com/your-username/podx.git
cd podx/packages/mcp-server
bun install

# Build the package
bun run build

# Run in development mode
bun run dev

# Run tests
bun test

Architecture

The MCP server is built on the official TypeScript SDK and integrates with the PODx monorepo packages:

@podx/core: Core utilities and types
@podx/scraper: Twitter scraping and data extraction
@modelcontextprotocol/sdk: Official MCP SDK

API Reference

Tool Definitions

All tools follow the MCP tool specification with Zod schema validation:

interface ToolDefinition {
  title: string;
  description: string;
  inputSchema: ZodSchema;
  handler: (args: any) => Promise<any>;
}

Resource Templates

Resources use URI templates for dynamic content:

const template = new ResourceTemplate(
  'podx://resource-type/{parameter}',
  { list: undefined }
);

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Submit a pull request