feat(mcp): add Social Sentiment Trading MCP Server

[FidelCoder]

Summary

Related Issue(s): #349

This PR adds a new Social Sentiment Trading MCP Server that aggregates social sentiment from multiple platforms (Reddit, Twitter/X, Farcaster, Discord, Telegram) and provides real-time sentiment analysis, early signal detection, and social momentum scoring for DeFi tokens.

Type of Change:

• 🔧 MCP server (new MCP integration)

🧪 Testing

Tests Performed:

• Manual testing of all 4 MCP tools using MCP Inspector
• Verified sentiment aggregation across Reddit, Twitter/X, and Farcaster
• Tested caching mechanism and rate limit handling
• Verified error handling for missing API keys
• Tested with multiple tokens (ETH, BTC, ARB, UNI)

Test Results:

• All tools return structured JSON responses
• Sentiment analysis works across all configured platforms
• Early signal detection correctly identifies volume spikes
• Momentum scoring calculates accurate scores
• Token listing returns all supported tokens

Steps to Run Tests:

1. Set up environment variables in .env (see README.md)
2. Build: pnpm build
3. Start MCP server: pnpm start
4. Use MCP Inspector to test tools:
   • analyze-social-sentiment: {"tokenSymbol": "ETH", "timeRange": {"hours": 24}}
   • social-momentum-score: {"tokenSymbol": "ETH"}
   • detect-early-signals: {"tokenSymbol": "ARB", "lookbackHours": 24}
   • list-supported-tokens: {}

Checklists

Code Quality

• Code follows project conventions and style guidelines
• TypeScript compilation passes (pnpm build)
• Linting passes (pnpm lint)
• No any types introduced
• Error handling implemented appropriately
• Security best practices followed (no exposed secrets/keys)

Documentation

• Code is self-documenting or includes necessary comments
• README updated if applicable
• Configuration options documented

Agent/MCP Specific

• MCP protocol compliance verified
• Agent skills and tools properly defined
• Error handling for external API failures
• Rate limiting and retry logic implemented
• Configuration options documented

Deployment Notes

New Dependencies Added:

• discord.js (^14.25.1)
• node-telegram-bot-api (^0.66.0)
• node-fetch (^3.3.2)
• lru-cache (^10.2.0)

New Environment Variables:

• TWITTER_BEARER_TOKEN (optional)
• NEYNAR_API_KEY (optional)
• DISCORD_BOT_TOKEN (optional)
• DISCORD_CHANNEL_IDS (optional)
• TELEGRAM_BOT_TOKEN (optional)
• TELEGRAM_CHAT_IDS (optional)
• HUGGING_FACE_API_KEY (optional)
• REDDIT_USER_AGENT (optional)

MCP Tools

1. analyze-social-sentiment

   • Parameters: {"tokenSymbol": "ETH", "timeRange": {"hours": 24}}
   • Returns: Sentiment score, confidence, trend, sources breakdown, contextual analysis, DeFi categories

2. social-momentum-score

   • Parameters: {"tokenSymbol": "ETH"}
   • Returns: Momentum score (0-100), breakdown by platform, velocity, volume, interpretation

3. detect-early-signals

   • Parameters: {"tokenSymbol": "ARB", "lookbackHours": 24}
   • Returns: Signal type, strength, description, historical comparison, relevant posts

4. list-supported-tokens

   • Parameters: {}
   • Returns: List of supported tokens with categories and metadata