
AiDD MCP Server

2025.04.17
53
PythonAI开发辅助代码分析版本控制开发效率
AiDD MCP Server 是一个为AI驱动的开发工作流提供全面工具集的MCP服务器。它具备文件系统操作、多语言代码分析(使用tree-sitter)、Git操作、代码执行和系统信息检索等功能,旨在增强AI在软件开发任务中的辅助能力。
View on GitHub
Overview
产品定位
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: 获取系统信息
屏幕上下文和图像工具
- get_active_apps: 获取活动应用列表
- get_available_windows: 获取可用窗口信息
- capture_screenshot: 捕获屏幕截图
- read_image_file: 读取图像文件
代码执行
- execute_code: 执行多种编程语言代码
- execute_shell_script: 执行shell脚本
常见问题解答
- 如何限制工作区范围?
通过配置文件
~/.aidd/config.json
中的allowed_directory
设置 - 如何调试工具执行?
使用
aidd-cli --debug
参数或MCP Inspector工具 - 代码执行有哪些安全限制? 有时间限制、工作区限制和权限控制
- 支持哪些编程语言的代码分析? 支持Python、JavaScript、TypeScript、Java、C++、Ruby、Go、Rust、PHP、C#、Kotlin等
使用教程
使用依赖
需要安装Node.js和Python环境
安装教程
通过Smithery安装
npx -y @smithery/cli install mcp-server-aidd --client claude
手动安装
# 使用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
基本工具调试命令示例:
# 读取文件
aidd-cli --tool read_file --args '{"path": "src/main.py"}'
# 获取系统信息
aidd-cli --tool get_system_info
# 执行Python代码
aidd-cli --tool execute_code --args '{"language": "python", "code": "print(sum(range(10)))"}'