使用说明

项目简介

SkyDeckAI Code (原名 MCP-Server-AIDD) 是一款基于 Model Context Protocol (MCP) 构建的服务器，旨在增强 AI 在软件开发任务中的能力。它提供了一系列工具，使 AI 能够访问和操作本地及远程资源，从而更好地辅助代码编写、分析和管理。

主要功能点

文件系统操作: 支持读取、写入、编辑、移动、复制和删除文件，以及目录管理和遍历。
多语言代码分析: 利用 tree-sitter 进行代码分析，支持多种编程语言，帮助 AI 理解代码结构。
代码内容搜索: 支持正则表达式的代码内容搜索，快速定位代码片段。
多语言代码执行: 提供安全的代码执行环境，支持多种编程语言的代码运行。
Git 操作: 集成 Git 常用操作，如状态查看、差异比较、提交、分支管理和代码仓库克隆。
Web 内容获取: 能够从 Web API 和网站获取内容。
批量工具执行: 支持并行和串行批量执行多个工具，提高效率。
系统信息: 获取全面的系统信息，为 AI 提供环境上下文。
屏幕上下文和图像工具: 包括屏幕截图、窗口信息和图像文件读取工具，增强视觉上下文感知能力。

安装步骤

SkyDeckAI Code 支持多种安装方式：

使用 pip 或 uv (推荐)

# 使用 pip
pip install skydeckai-code

# 使用 uv (更快)
uv pip install skydeckai-code

使用 McpGet

npx @michaellatman/mcp-get@latest install skydeckai-code

使用 Smithery (Claude Desktop 自动安装)

npx -y @smithery/cli install skydeckai-code --client claude

服务器配置

要将 SkyDeckAI Code 配置为 MCP 服务器供 MCP 客户端（例如 Claude Desktop）使用，您需要在客户端的配置文件中添加服务器信息。以 'claude_desktop_config.json' 为例，配置信息如下：

{
    "mcpServers": {
        "skydeckai-code": { # 服务器名称，客户端用此名称引用
            "command": "uvx", # 启动服务器的命令，这里假设 uvx 可执行文件在 PATH 中
            "args": ["skydeckai-code"] # 命令参数，这里指定运行 skydeckai-code
        }
    }
}

'server name': 'skydeckai-code' - 客户端用此名称来识别和调用该 MCP 服务器。
'command': 'uvx' - 启动 SkyDeckAI Code 服务器的命令。如果使用 'pip' 安装，则应为 'skydeckai-code-cli'。如果使用 'uv' 安装，并且 'uvx' 可执行文件在 PATH 中，可以使用 'uvx'。
'args': '["skydeckai-code"]' - 传递给启动命令的参数，这里表示运行 'skydeckai-code' 服务。如果 'command' 设置为 'skydeckai-code-cli'，则 'args' 可以为空数组 '[]'。

基本使用方法

SkyDeckAI Code 提供了命令行界面 (CLI) 'skydeckai-code-cli' 用于直接调用工具进行测试和调试。

列出可用工具

skydeckai-code-cli --list-tools

调用工具

skydeckai-code-cli --tool <工具名称> --args '<JSON 格式的参数>'

# 例如，列出当前目录内容
skydeckai-code-cli --tool list_directory --args '{"path": "."}'

# 例如，读取文件内容
skydeckai-code-cli --tool read_file --args '{"path": "README.md"}'

调试模式

skydeckai-code-cli --debug --tool <工具名称> --args '<JSON 格式的参数>'

使用 '--debug' 参数可以启用调试输出，帮助诊断问题。您还可以使用 MCP Inspector 工具进行更详细的调试。

关键词

使用说明

信息