AiDD MCP Server

AiDD MCP Server

site icon
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脚本

常见问题解答

  1. 如何限制工作区范围? 通过配置文件~/.aidd/config.json中的allowed_directory设置
  2. 如何调试工具执行? 使用aidd-cli --debug参数或MCP Inspector工具
  3. 代码执行有哪些安全限制? 有时间限制、工作区限制和权限控制
  4. 支持哪些编程语言的代码分析? 支持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)))"}'

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。