AiDD MCP Server

基本能力

产品定位

AiDD MCP Server 是一个专为AI辅助软件开发设计的工具集，提供从文件操作到代码分析、版本控制等一系列开发相关功能。

核心功能

• 文件系统操作（读写、编辑、移动、删除）
• 目录管理与遍历
• 使用tree-sitter进行多语言代码分析
• 带安全措施的多语言代码执行
• Git操作（状态、差异、提交、分支管理）
• 带可配置工作区边界的安全控制

适用场景

• AI辅助代码开发
• 自动化开发工作流
• 代码分析与重构
• 版本控制管理
• 系统信息监控

工具列表

基础文件操作

• read_file：读取文件内容
• read_multiple_files：读取多个文件内容
• write_file：写入文件
• move_file：移动文件
• delete_file：删除文件
• get_file_info：获取文件元数据

复杂文件操作

• edit_file：基于模式的文件编辑

目录操作

• get_allowed_directory：获取允许目录
• update_allowed_directory：更新允许目录
• list_directory：列出目录内容
• create_directory：创建目录
• search_files：搜索文件
• directory_tree：生成目录结构

Git操作

• git_init：初始化仓库
• git_status：查看状态
• git_add：添加文件
• git_reset：重置更改
• git_checkout：切换分支
• git_commit：提交更改
• git_diff：查看差异
• git_log：查看提交历史

代码分析

• tree_sitter_map：分析源代码结构

系统信息

• get_system_info：获取系统信息

代码执行

• execute_code：执行多语言代码
• execute_shell_script：执行shell脚本

常见问题解答

• 安全警告：该工具会执行系统上的任意代码，请始终审查代码并理解其目的
• 要求：相应语言的运行时必须已安装
• 配置：通过~/.aidd/config.json配置允许目录

使用教程

使用依赖

无特殊依赖，但需要相应语言的运行时环境（如Python、Node.js等）

安装教程

# 使用mcp-get安装
npx @michaellatman/mcp-get@latest install mcp-server-aidd

# 使用pip安装
pip install mcp-server-aidd

# 使用uv安装
uvx mcp-server-aidd

Claude Desktop设置

在claude_desktop_config.json中添加：

{
    "mcpServers": {
        "aidd-ai-software-development-utilities": {
            "command": "uvx",
            "args": ["mcp-server-aidd"]
        }
    }
}

调试方式

使用MCP Inspector进行调试：

npx @modelcontextprotocol/inspector run

基本CLI使用：

# 列出可用工具
aidd-cli --list-tools

# 启用调试输出
aidd-cli --debug --tool <tool_name> --args '<json_arguments>'

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。