MCP Server Aidd

](https://mseep.ai/app/skydeckai-code)

SkyDeckAI代码

MCP服务器为AI驱动的开发工作流程提供了一套全面的工具。功能包括文件系统操作、使用多种编程语言的树形图进行代码分析、代码执行、使用HTML到markdown转换获取web内容、多引擎web搜索、代码内容搜索和系统信息检索。旨在通过提供对本地和远程资源的直接访问来增强人工智能协助软件开发任务的能力。

以前称为MCP服务器AIDD

此mcp服务器以前称为 mcp-server-aidd。它被重命名为 skydeckai-code 感谢团队 SkyDeck.ai 随着创建此应用程序 东方敏捷。但更重要的是，我们意识到人工智能驱动开发（AIDD）一词并没有流行起来。人们一眼就不明白它是什么。LLMs也没有。“代码”要直观得多。语言直觉在人工智能领域很重要。


安装

# Using uvx
uvx skydeckai-code

Claude桌面设置

添加到您的 claude_desktop_config.json:

{
    "mcpServers": {
        "skydeckai-code": {
            "command": "uvx",
            "args": ["skydeckai-code"]
        }
    }
}

SkyDeck人工智能助手应用程序

如果你正在使用MseeP AI Helper应用程序，你可以搜索“SkyDeckAI代码”并安装它。

MseeP AI Helper App

主要特点

• 文件系统操作（读、写、编辑、移动、复制、删除）
• 目录管理和遍历
• 基于树形图的多语言代码分析
• 使用正则表达式模式匹配进行代码内容搜索
• 具有安全措施的多语言代码执行
• 通过HTML到markdown转换从API和网站获取Web内容
• 具有可靠回退机制的多引擎网络搜索
• 并行和串行工具执行的批处理操作
• 具有可配置工作区边界的安全控制
• 屏幕截图和屏幕上下文工具
• 图像处理工具

可用工具（29）

详细的工具文档

基本文件操作

复杂的文件操作

edit_file

基于模式的文件编辑，支持预览：

{
    "path": "src/main.py",
    "edits": [
        {
            "oldText": "def old_function():",
            "newText": "def new_function():"
        }
    ],
    "dryRun": false,
    "options": {
        "partialMatch": true
    }
}

返回值：在模拟运行模式下更改或预览的差异。

目录操作

这 search_files 该工具按名称模式搜索文件，而 search_code 该工具使用正则表达式在文件内容中搜索。使用 search_files 查找具有特定名称或扩展名的文件时，以及 search_code 在文件中搜索特定的文本模式时。

目录树

生成完整的目录结构：

{
    "path": "src",
    "include_hidden": false
}

返回：目录内容的JSON树结构。

代码分析

代码库映射器

分析源代码结构：

{
    "path": "src"
}

退货：

• 类及其方法
• 功能和参数
• 模块结构
• 代码组织统计
• 继承关系

支持的语言：

• Python（.py）
• JavaScript（.js/.jsx、.mjs、.cjs）
• TypeScript（.ts/.tsx）
• Java（.Java）
• C++（.cpp、.hpp、.cc）
• Ruby（.rb、.rake）
• 去（.去）
• 锈蚀（.rs）
• PHP（.PHP）
• C#（.cs）
• Kotlin（.kt，.kts）

搜索代码

使用正则表达式的快速内容搜索工具：

{
    "patterns": ["function\\s+\\w+", "class\\s+\\w+"],
    "include": "*.js",
    "exclude": "node_modules/**",
    "max_results": 50,
    "case_sensitive": false,
    "path": "src"
}

参数：

退货： 按文件分组的行与行号匹配，按文件修改时间排序，最新文件优先。

此工具在可获得最佳性能时使用ripgrep，并使用Python回退实现。它非常适合查找特定的代码模式，如函数声明、导入、变量使用或错误处理。

系统信息

退货：

{
  "working_directory": "/path/to/project",
  "system": {
    "os", "os_version", "architecture", "python_version"
  },
  "wifi_network": "MyWiFi",
  "cpu": {
    "physical_cores", "logical_cores", "total_cpu_usage"
  },
  "memory": { "total", "available", "used_percentage" },
  "disk": { "total", "free", "used_percentage" },
  "mac_details": {  // Only present on macOS
    "model": "Mac mini",
    "chip": "Apple M2",
    "serial_number": "XXX"
  }
}

以清晰易读的格式提供基本系统信息。

屏幕上下文和图像工具

获取活动应用程序

返回用户系统上当前活动应用程序的列表。

{
    "with_details": true
}

参数：

退货：

{
    "success": true,
    "platform": "macos",
    "app_count": 12,
    "apps": [
        {
            "name": "Firefox",
            "has_windows": true,
            "window_count": 3,
            "visible_windows": [
                { "name": "GitHub - Mozilla Firefox", "width": 1200, "height": 800 }
            ]
        },
        {
            "name": "VSCode",
            "has_windows": true
        }
    ]
}

此工具提供了有关用户系统上当前运行的应用程序的有价值的上下文，这有助于提供更相关的帮助。

get_available_windows

返回用户屏幕上当前显示的所有可用窗口的详细信息。

{}

退货：

{
    "success": true,
    "platform": "macos",
    "count": 8,
    "windows": [
        {
            "id": 42,
            "title": "Document.txt - Notepad",
            "app": "Notepad",
            "visible": true
        },
        {
            "title": "Terminal",
            "app": "Terminal",
            "visible": true,
            "active": true
        }
    ]
}

此工具有助于了解用户屏幕上可见的内容，并可用于上下文感知帮助。

capture_screenshot

捕获用户屏幕或特定窗口的屏幕截图。

{
    "output_path": "screenshots/capture.png",
    "capture_mode": {
        "type": "named_window",
        "window_name": "Visual Studio Code"
    }
}

参数：

退货：

{
    "success": true,
    "path": "/path/to/screenshots/capture.png"
}

此工具捕获屏幕截图以进行可视化、调试或上下文感知帮助。

read_image_file

从文件系统读取图像文件，并将其内容作为base64编码字符串返回。

{
    "path": "images/logo.png"
}

参数：

退货： 可以显示或处理的Base64编码图像数据。

此工具支持PNG、JPEG、GIF和WebP等常见图像格式，并自动调整图像大小以获得最佳查看效果。

Web工具

web_fetch

从URL获取内容，并可选择将其保存到文件中。

{
    "url": "https://api.github.com/users/octocat",
    "headers": {
        "Accept": "application/json"
    },
    "timeout": 15,
    "save_to_file": "downloads/octocat.json",
    "convert_html_to_markdown": true
}

参数：

退货： 响应内容为带有HTTP状态代码和大小信息的文本。对于二进制内容，如果需要，返回元数据并保存到文件中。启用convert_html_to_markdown后，html内容会自动转换为markdown格式，以提高可读性。

此工具可用于访问web API、获取文档或从web下载内容，同时遵守大小限制（最大10MB）和安全约束。

网络搜索

使用多个搜索引擎执行强大的网络搜索，并返回简洁、相关的结果。

{
    "query": "latest python release features",
    "num_results": 8,
    "convert_html_to_markdown": true,
    "search_engine": "bing"
}

参数：

退货： 以markdown格式显示的搜索结果列表，包括每个结果的标题、URL和片段。结果经过重复数据消除和分层组织，便于阅读。

该工具使用多引擎方法，尝试使用不同解析策略的不同搜索引擎，以确保可靠的结果。您可以指定首选引擎，但某些引擎可能会阻止自动访问，在这种情况下，当选择“自动”时，该工具将回退到其他引擎。

实用工具

批处理工具

在单个请求中执行多个工具调用，并在可能的情况下并行执行。

{
    "description": "Setup new project",
    "sequential": true,
    "invocations": [
        {
            "tool": "create_directory",
            "arguments": {
                "path": "src"
            }
        },
        {
            "tool": "write_file",
            "arguments": {
                "path": "README.md",
                "content": "# New Project\n\nThis is a new project."
            }
        },
        {
            "tool": "execute_shell_script",
            "arguments": {
                "script": "git init"
            }
        }
    ]
}

参数：

退货： 所有工具调用的组合结果，按工具分组，每个工具的成功/错误状态。结果以原始调用顺序呈现，并带有清晰的节标题。

此工具可在单个请求中高效执行多个操作。当 sequential 如果为false（默认），则并行执行工具以获得更好的性能。当 sequential 如果为true，则按顺序执行工具，如果任何工具发生故障，则停止执行。

重要：批处理中的所有工具都在相同的工作目录上下文中执行。如果一个工具创建了一个目录，而后续工具需要在该目录内工作，您必须：

1. 使用相对于当前工作目录的路径（例如，“project/src”而不仅仅是“src”），或
2. 包括使用以下命令更改目录的显式工具调用 update_allowed_directory

思考

一种用于复杂推理和头脑风暴的工具，无需对存储库进行更改。

{
    "thought": "Let me analyze the performance issue in the codebase:\n\n## Root Cause Analysis\n\n1. The database query is inefficient because:\n   - It doesn't use proper indexing\n   - It fetches more columns than needed\n   - The JOIN operation is unnecessarily complex\n\n## Potential Solutions\n\n1. **Add database indexes**:\n   - Create an index on the user_id column\n   - Create a composite index on (created_at, status)\n\n2. **Optimize the query**:\n   - Select only necessary columns\n   - Rewrite the JOIN using a subquery\n   - Add LIMIT clause for pagination\n\n3. **Add caching layer**:\n   - Cache frequent queries using Redis\n   - Implement cache invalidation strategy\n\nAfter weighing the options, solution #2 seems to be the simplest to implement with the highest impact."
}

参数：

退货： 你的想法格式为markdown，并附有一条注释，表明这是一次思考练习。

此工具可用于思考复杂问题、头脑风暴解决方案或制定实施计划，而无需进行任何实际更改。这是记录你的推理过程、评估不同方法或在采取行动之前制定多步骤策略的好方法。

代码执行

execute_code

执行具有安全措施和限制的各种编程语言的代码。

{
    "language": "python",
    "code": "print('Hello, World!')",
    "timeout": 5
}

支持的语言：

• Python（python3）
• JavaScript（Node.js）
• 红宝石
• PHP
• 去
• 锈

参数：

要求：

• 必须安装相应的语言运行时
• 命令必须在系统PATH中可用
• 临时文件创建的适当权限

⚠️ 安全警告： 此工具在您的系统上执行任意代码。始终：

1. 执行前彻底检查代码
2. 了解代码的目的和预期结果
3. 从不执行不受信任的代码
4. 注意潜在的系统影响
5. 监控执行输出

execute_shell_script

执行带有安全措施和限制的shell脚本（bash/sh）。

{
    "script": "echo \"Current directory:\" && pwd",
    "timeout": 300
}

参数：

特征：

• 使用/bin/sh实现跨系统的最大兼容性
• 在允许的目录内执行
• 分离stdout和stderr输出
• 正确的错误处理和超时控制

⚠️ 安全警告： 此工具在您的系统上执行任意shell命令。始终：

1. 执行前彻底检查脚本
2. 了解脚本的目的和预期结果
3. 从不执行不受信任的脚本
4. 注意潜在的系统影响
5. 监控执行输出

Todo工具

todo工具为工作空间优先的开发工作流提供了顺序任务管理功能。任务按顺序执行，没有优先级系统，确保开发阶段的结构化进度。

todo_read

读取工作区的当前待办事项列表。

{}

退货：

{
  "todos": [
    {
      "id": "abc123",
      "content": "Implement user authentication",
      "status": "in_progress",
      "metadata": {
        "custom_key": "custom_value"
      },
      "created_at": "2023-10-01T10:00:00Z",
      "updated_at": "2023-10-01T11:30:00Z"
    }
  ],
  "count": 1,
  "workspace": "/path/to/workspace"
}

todo_write

替换顺序执行工作流的整个待办事项列表。任务按照数组顺序执行，以之前的工作为基础。

{
  "todos": [
    {
      "id": "task1",
      "content": "Set up database schema",
      "status": "pending"
    },
    {
      "id": "task2", 
      "content": "Create API endpoints",
      "status": "pending",
      "metadata": {
        "custom_key": "custom_value"
      }
    }
  ]
}

顺序工作流规则：

• 每个todo必须有唯一的ID
• 一次只能有一个任务“in_progress”（顺序执行）
• 任务按数组顺序执行-无优先级系统
• 必填字段：id、内容、状态
• 状态值：“待定”、“正在进行中”、“已完成”
• 工作区优先：所有工作区操作都必须进行待办事项管理

Tod/update

按ID更新特定待办事项，以实现连续的工作流进程。

{
  "todo_id": "task1",
  "updates": {
    "status": "in_progress",
    "metadata": {
        "new_key": "new_value"
    }
  }
}

退货：

{
  "success": true,
  "updated_todo": {
    "id": "task1",
    "content": "Set up database schema",
    "status": "in_progress",
    "updated_at": "2023-10-01T12:00:00Z",
    "metadata": {
        "new_key": "new_value"
    }
  },
  "counts": {
    "pending": 1,
    "in_progress": 1,
    "completed": 0,
    "total": 2
  },
  "workspace": "/path/to/workspace"
}

todo系统为每个工作区维护单独的顺序任务列表，强制所有工作区操作使用。任务按顺序执行，建立在以前的工作基础上，没有基于优先级的调度。

配置

配置文件： ~/.skydeckai_code/config.json

{
    "allowed_directory": "/path/to/workspace"
}

调试

使用MCP检查器进行调试：

npx @modelcontextprotocol/inspector run

安全

• 操作仅限于配置的允许目录
• 路径遍历预防
• 文件权限保留
• 安全操作处理

即将推出的功能

• GitHub工具：

- PR描述生成器 - 代码审查 - 行动管理器

• Pivotal Tracker工具：

- 故事生成器 - 故事经理

开发状态

目前正在积极开发中。功能和API可能会更改。

许可证

Apache许可证2.0-请参阅 许可证