MCP Agent Social Media Server

--- title: '2:14:48 PM - June 7, 2025' date: 2025-06-07T19:14:48.592Z timestamp: 1749323688592 --- ## Project Notes MCP Social Media Server Analysis: **Architecture Overview:** - Main entry: src/index.ts - registers 3 tools (login, read_posts, create_post) - Uses StdioServerTransport for MCP communication - Session management via global session ID per connection - API client adapts between MCP schema and external API schema **Key Components:** 1. **Tools** (src/tools/): - login.ts: Authentication, creates/updates sessions - read-posts.ts: Fetches posts with filtering/pagination - create-post.ts: Creates posts, requires authentication 2. **Core Services**: - SessionManager: In-memory session storage with async locking - ApiClient: HTTP client with retry, timeout, error handling - Logger: Structured logging with context - Metrics: Performance monitoring, operation tracking 3. **Security/Validation**: - Zod schemas for tool inputs - Custom validation layer with detailed error messages - API key authentication for external API - Session validation for post creation **Configuration** (via env vars): - SOCIALMEDIA_API_BASE_URL - SOCIALMEDIA_API_KEY - SOCIALMEDIA_TEAM_ID - LOG_LEVEL, API_TIMEOUT **Not Implemented**: - MCP resources - MCP prompts - MCP sampling - Rate limiting (relies on external API) - Session persistence - Multi-team support