{"id":29276897,"url":"https://github.com/qduc/aider-mcp","last_synced_at":"2025-10-11T02:02:37.597Z","repository":{"id":296524134,"uuid":"993679145","full_name":"qduc/aider-mcp","owner":"qduc","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-01T08:29:00.000Z","size":41,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-05T09:41:15.555Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qduc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-31T09:29:39.000Z","updated_at":"2025-06-01T08:29:03.000Z","dependencies_parsed_at":"2025-05-31T21:27:44.983Z","dependency_job_id":"d4fe5eec-cecd-4a6a-ab1d-3c60145837af","html_url":"https://github.com/qduc/aider-mcp","commit_stats":null,"previous_names":["qduc/aider-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/qduc/aider-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qduc%2Faider-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qduc%2Faider-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qduc%2Faider-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qduc%2Faider-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qduc","download_url":"https://codeload.github.com/qduc/aider-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qduc%2Faider-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279005874,"owners_count":26083989,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-05T09:30:43.467Z","updated_at":"2025-10-11T02:02:37.591Z","avatar_url":"https://github.com/qduc.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aider MCP Server\n\nA Model Context Protocol (MCP) server that integrates with Aider CLI, enabling AI models to execute natural language programming tasks through the Aider AI pair programming assistant.\n\n## Overview\n\nThis MCP server acts as a bridge between AI models and Aider CLI, allowing you to:\n\n- Execute natural language programming prompts via Aider CLI\n- Perform code generation, debugging, and refactoring tasks in focused, one-shot sessions\n- Access file operations within specified working directories\n- Select from various AI models (DeepSeek Reasoner, Gemini 2.5 Pro, etc.)\n- Use architect mode for complex tasks requiring planning and coordination\n- Maintain context across sessions with chat history restoration\n\n## Features\n\n- **Natural Language Processing**: Send programming tasks and questions in plain English\n- **Architect Mode**: Break down complex problems with specialized architect and editor models\n- **Auto-commit Mode**: Automatically apply and commit code changes suggested by Aider\n- **Working Directory Control**: Specify custom working directories for file operations\n- **Advanced Model Selection**: Choose from optimized AI models including DeepSeek Reasoner, Gemini 2.5 Pro, and more\n- **Chat History Restoration**: Maintain context across sessions for continuous development\n- **Enhanced Output Recovery**: Intelligent summary extraction from Aider's chat history\n- **File-Specific Operations**: Target specific files for focused editing tasks\n- **Error Handling**: Comprehensive error reporting and logging\n\n## Prerequisites\n\n- **Node.js**: Version 22.0.0 or later\n- **Aider CLI**: Must be installed and accessible in your PATH\n- **MCP Client**: Compatible with Claude Desktop, VS Code with MCP extension, or other MCP clients\n\n## Installation\n\n1. **Clone the repository:**\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd aider-mcp\n   ```\n\n2. **Install dependencies:**\n   ```bash\n   npm install\n   ```\n\n3. **Ensure Aider CLI is installed:**\n   ```bash\n   # Verify Aider CLI is available\n   aider --help\n   ```\n\n## Usage\n\n### Starting the Server\n\n```bash\nnpm start\n```\n\nFor development with auto-reload:\n```bash\nnpm run dev\n```\n\n### Configuration\n\nConfigure your MCP client to connect to this server. For Claude Desktop, add the following to your configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"aider\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/aider-mcp/server.js\"]\n    }\n  }\n}\n```\n\n### Available Tools\n\n#### `aider_execute`\n\nExecute Aider CLI commands with natural language prompts. Ideal for focused, one-shot coding tasks.\n\n**Parameters:**\n- `prompt` (required): Natural language instruction for Aider CLI\n- `workingDir` (optional): Absolute path to working directory\n- `files` (optional): Array of specific files required for the task\n- `model` (optional): AI model to use (default: \"deepseek\")\n  - `deepseek/deepseek-reasoner`: Excellent reasoning and cost-effective\n  - `gemini/gemini-2.5-pro-preview-05-06`: High performance and excellent balance\n  - `deepseek`: Fast and economical\n- `restoreChatHistory` (optional): Enable Aider to remember past conversations\n\n#### `aider_architect`\n\nExecute Aider CLI in architect mode for complex coding tasks requiring planning and coordination.\n\n**Parameters:**\n- `prompt` (required): Complex coding task or architectural challenge\n- `workingDir` (optional): Absolute path to working directory\n- `files` (optional): Array of specific files required for the task\n- `architectModel` (optional): Model for high-level planning (default: \"deepseek/deepseek-reasoner\")\n- `editorModel` (optional): Model for implementation (auto-selected if not specified)\n- `restoreChatHistory` (optional): Enable Aider to remember past conversations\n\n**Example Usage:**\n```\nCreate a Python script that reads CSV files and generates a summary report\n```\n\n### Available Resources\n\n#### `aider://help`\n\nAccess Aider CLI help and usage information directly through the MCP interface.\n\n### Available Prompts\n\n#### `aider_assistance`\n\nGet structured coding assistance using Aider CLI.\n\n**Parameters:**\n- `task` (required): The coding task or problem to solve\n- `context` (optional): Additional context or requirements\n\n## Examples\n\n### Basic Code Generation\n```\nGenerate a React component for a todo list with add, edit, and delete functionality\n```\n\n### Bug Fixing\n```\nFix the memory leak in the Node.js application in the /path/to/project directory\n```\n\n### Code Refactoring\n```\nRefactor the legacy jQuery code to modern vanilla JavaScript\n```\n\n### Architect Mode for Complex Tasks\n```\nDesign and implement a microservices architecture for a task management system with authentication, real-time updates, and database persistence\n```\n\n### Working with Specific Files\n```\nRefactor the React components in src/components/UserManagement.js to use TypeScript and add proper error handling\n```\n\n### Chat History Context\n```\nContinue improving the API based on our previous discussion about rate limiting and error handling\n```\n\n## API Reference\n\n### Tool: aider_execute\n\nExecutes Aider CLI with the following options:\n- `--yes`: Accept all suggestions automatically\n- `--auto-commits`: Automatically commit changes\n- `--model \u003cmodel\u003e`: Specify the AI model to use\n\n### Tool: aider_architect\n\nExecutes Aider CLI in architect mode with the following options:\n- `--architect`: Enable architect mode for complex tasks\n- `--model \u003carchitectModel\u003e`: Specify the architect model for planning\n- `--editor-model \u003ceditorModel\u003e`: Specify the editor model for implementation\n\n### Error Handling\n\nThe server provides detailed error messages for:\n- Aider CLI execution failures\n- Invalid working directories\n- Missing dependencies\n- Permission issues\n\n## Development\n\n### Project Structure\n\n```\naider-mcp/\n├── server.js          # Main MCP server implementation\n├── package.json       # Node.js dependencies and scripts\n├── README.md          # This file\n├── mcp_develop_guide.md # MCP development guide\n└── aider-help.txt     # Aider CLI reference\n```\n\n### Adding New Features\n\n1. **Tools**: Add new tool definitions in `server.js` using `server.tool()`\n2. **Resources**: Implement new resources using `server.resource()`\n3. **Prompts**: Create prompt templates using `server.prompt()`\n\n### Testing\n\nTest the server manually by running:\n\n```bash\nnpm start\n```\n\nThen connect with an MCP client to verify functionality.\n\n## Troubleshooting\n\n### Common Issues\n\n1. **\"Aider CLI not found\"**\n   - Ensure Aider CLI is installed and in your PATH\n   - Verify with `which aider` or `aider --version`\n\n2. **Permission denied errors**\n   - Check file permissions in the working directory\n   - Ensure the user has write access to target directories\n\n3. **Connection issues**\n   - Verify the MCP client configuration\n   - Check that Node.js version meets requirements (≥22.0.0)\n\n### Debug Mode\n\nEnable detailed logging by checking the console output when running the server:\n\n```bash\nnpm start\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature-name`\n3. Make your changes and test thoroughly\n4. Commit your changes: `git commit -am 'Add feature'`\n5. Push to the branch: `git push origin feature-name`\n6. Submit a pull request\n\n## License\n\nThis project is licensed under the MIT License. See the package.json file for details.\n\n## Related Projects\n\n- [Model Context Protocol](https://github.com/modelcontextprotocol/specification)\n- [Aider CLI](https://github.com/Aider-AI/aider) - The underlying CLI tool\n- [Claude Desktop](https://claude.ai/desktop) - MCP client\n\n## Support\n\nFor issues and questions:\n1. Check the troubleshooting section above\n2. Review Aider CLI documentation\n3. Open an issue in the repository\n\n---\n\n**Note**: This server requires Aider CLI to be properly installed and configured on your system. Make sure you have the necessary permissions and access to use Aider CLI before using this MCP server.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqduc%2Faider-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqduc%2Faider-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqduc%2Faider-mcp/lists"}