项目简介

AiDD MCP Server 是一个专为 AI 驱动的软件开发工作流程设计的 Model Context Protocol (MCP) 服务器。它旨在提升大型语言模型 (LLM) 在软件开发任务中的辅助能力，通过提供一系列工具，使得 AI 能够更有效地理解和操作开发环境。

主要功能点

文件系统操作: 支持读取、写入、编辑、移动和删除文件，以及创建、列出和搜索目录，方便 AI 进行代码和项目文件的管理。
代码分析: 集成 tree-sitter 库，能够对多种编程语言的代码进行结构化分析，提取类、函数、方法等信息，帮助 AI 理解代码结构。
Git 操作: 提供 Git 版本控制系统的常用操作，如初始化仓库、查看状态、添加文件、提交更改、分支管理等，使 AI 能够参与代码的版本管理流程。
代码执行: 允许安全地执行多种编程语言的代码片段和 Shell 脚本，并返回执行结果，使 AI 能够进行代码测试和环境交互。
系统信息: 能够获取运行服务器的计算机的系统信息，包括操作系统、CPU、内存、磁盘使用情况、网络状态等，为 AI 提供环境感知能力。
工作区安全: 所有文件和目录操作都限制在预先配置的允许目录范围内，保障本地文件系统的安全。

安装步骤

你可以使用以下任一包管理器安装 AiDD MCP Server：

# 使用 mcp-get (推荐)
npx @michaellatman/mcp-get@latest install mcp-server-aidd

# 使用 pip
pip install mcp-server-aidd

# 使用 uv
uvx mcp-server-aidd

服务器配置

要将 AiDD MCP Server 集成到支持 MCP 协议的客户端（例如 Claude Desktop），你需要配置客户端以连接到该服务器。配置信息通常以 JSON 格式提供，以下是一个 'claude_desktop_config.json' 的配置示例：

{
    "mcpServers": {
        "aidd-ai-software-development-utilities": {  // 服务器名称，可以自定义，用于在客户端中标识
            "command": "uvx",                       // 启动服务器的命令，这里假设你使用 uv 安装，如果使用 pip 安装则为 "mcp-server-aidd"
            "args": ["mcp-server-aidd"]             // 传递给启动命令的参数，这里是服务器的包名
        }
    }
}

'server name': 为服务器自定义一个名称，方便在客户端界面中识别和管理。
'command': 启动 AiDD MCP Server 的命令。根据你的安装方式选择 '"uvx"' (如果使用 'uv' 安装) 或 '"mcp-server-aidd"' (如果使用 'pip' 安装)。
'args': 启动命令的参数。对于 AiDD MCP Server，参数通常是服务器的包名 '["mcp-server-aidd"]'。

基本使用方法

安装完成后，你可以通过 'aidd-cli' 命令行工具与 AiDD MCP Server 进行交互，测试和使用各项工具功能。

列出所有可用工具:

aidd-cli --list-tools

调用工具 (例如，读取文件):

aidd-cli --tool read_file --args '{"path": "README.md"}'

调用工具 (例如，执行 Python 代码):

aidd-cli --tool execute_code --args '{"language": "python", "code": "print(\\"Hello, World!\\")"}'

更多 'aidd-cli' 的命令和工具的具体参数，可以通过运行 'aidd-cli --help' 命令或查阅仓库的 README 文档获取。

调试

可以使用 MCP Inspector 工具进行调试：

npx @modelcontextprotocol/inspector run

安全注意

请务必仔细审查所有使用代码执行和 Shell 脚本执行工具的代码，确保其安全性和可信度，避免执行未知的或恶意的代码。所有文件系统操作都限制在配置的允许目录内，但仍需谨慎操作。

关键词

信息