Instagram MCP Server

# Instagram MCP Server A Model Context Protocol (MCP) server for fetching Instagram posts using Chrome's existing login session. ## Features - Modular architecture with clear separation of concerns - Type-safe implementation using TypeScript - Improved error handling and logging - Configurable through environment variables - JSON-RPC 2.0 compliant communication - Automatic media downloading and metadata generation - SEO-friendly description generation ## Architecture The server follows a modular architecture with the following structure: ``` src/ ├── core/ # Core MCP functionality │ ├── mcp/ # MCP server implementation │ │ ├── server.ts # Server class │ │ ├── stdio.ts # StdioServerTransport │ │ └── index.ts # Barrel exports │ ├── types/ # Core type definitions │ │ └── mcp.ts # MCP types │ └── utils/ # Utility functions │ ├── config.ts # Configuration management │ └── errors.ts # Error handling ├── features/ # Feature modules │ └── instagram/ # Instagram feature │ ├── types.ts # Instagram types │ ├── utils/ # Feature utilities │ │ ├── media.ts # Media handling │ │ ├── post.ts # Post processing │ │ └── seo.ts # SEO generation │ └── instagram.service.ts # Instagram service ├── services/ # Shared services │ └── browser/ # Browser service │ ├── types.ts # Browser types │ └── browser.service.ts # Browser service ├── index.ts # Entry point └── server.ts # Main server class ``` ## Configuration The server requires the following environment variables: - `CHROME_USER_DATA_DIR`: Path to Chrome user data directory containing login session Additional configuration options are available through the config manager: - Browser settings (viewport, timeouts) - Instagram settings (delays, batch sizes) - Save directory and file paths ## Usage 1. Install dependencies: ```bash npm install ``` 2. Build the server: ```bash npm run build ``` 3. Run the server: ```bash CHROME_USER_DATA_DIR=/path/to/chrome/profile npm start ``` ## Available Tools ### get_instagram_posts Fetches recent posts from an Instagram profile. Parameters: - `username` (required): Instagram username to fetch posts from - `limit` (optional): Number of posts to fetch (1-50) or "all" - `saveDir` (optional): Directory to save media files and metadata - `delayBetweenPosts` (optional): Milliseconds to wait between processing posts Example: ```json { "jsonrpc": "2.0", "id": 1, "method": "call_tool", "params": { "name": "get_instagram_posts", "arguments": { "username": "example", "limit": 10 } } } ``` ## Error Handling The server uses standardized error codes and messages: - `INVALID_REQUEST`: Invalid request format or parameters - `INVALID_PARAMS`: Missing or invalid parameters - `METHOD_NOT_FOUND`: Unknown method or tool - `INTERNAL_ERROR`: Server-side errors ## Development 1. Start in development mode: ```bash npm run dev ``` 2. Run linter: ```bash npm run lint ``` ## Improvements Over Original 1. **Modular Architecture** - Clear separation of concerns - Better code organization - Easier to maintain and extend 2. **Type Safety** - Comprehensive TypeScript types - Better error catching - Improved IDE support 3. **Error Handling** - Standardized error codes - Better error messages - Proper error propagation 4. **Configuration** - Centralized configuration - Environment variable validation - Type-safe config access 5. **Code Quality** - Consistent coding style - Better documentation - Improved logging 6. **Testing Support** - Modular design enables testing - Dependency injection ready - Clear interfaces ## License MIT