Skip to main content
Glama

mcp-dev-tools

通过 MCP (Model Context Protocol) 聚合 GitHub / GitLab / Figma 等开发工具的 Server。

支持所有兼容 MCP 的客户端:Claude Code、Codex、VS Code (Copilot)、Kiro、Cursor 等。

提供的工具

工具

说明

github_get_file

获取 GitHub 仓库中指定文件的内容

github_list_files

列出 GitHub 仓库的文件目录

github_search_code

搜索 GitHub 仓库代码

gitlab_get_file

获取 GitLab 仓库中指定文件的内容

gitlab_list_files

列出 GitLab 仓库的文件目录

gitlab_search_code

搜索 GitLab 仓库代码

figma_inspect

按前缀查找 Figma 设计稿中的节点

figma_tree

浏览 Figma 节点树(支持过滤)

figma_images

获取 Figma 节点导出图片 URL

figma_export

批量导出 Figma 节点图片(返回 URL + 映射)

figma_text

提取 Figma 设计稿中的文字、颜色和高亮

codex_exec

调用 Codex CLI 执行独立任务

claude_exec

调用 Claude Code CLI 执行独立任务,支持 direct / relay 模式

Related MCP server: all-agents-mcp

快速安装

需要 Node.js ≥ 18.0,可通过 node -v 检查版本。

git clone https://github.com/dan-0526/mcp-dev-tools.git ~/mcp-dev-tools
cd ~/mcp-dev-tools
npm install

获取 Token

按需准备,不用的平台留空即可:

  • GitHub: https://github.com/settings/tokens → Generate new token (classic) → 勾选 repo

  • GitLab: GitLab → Preferences → Access Tokens → 勾选 read_repository

  • Figma: Figma → 左上角头像 → Settings → Personal access tokens → Generate new token

⚠️ Token 不要提交到仓库,通过各客户端的 env 配置传入。

Claude Relay

claude_exec 默认使用 direct 模式:MCP server 进程直接执行 claude -p。默认会清理 HTTP_PROXY / HTTPS_PROXY / http_proxy / https_proxy,避免本机代理环境影响 Claude Code CLI。确实需要保留代理时,可以传 preserveProxyEnv: true

如果 MCP 客户端所在环境无法直接运行 Claude,可以改用 relay 模式:在正常网络环境中单独启动 relay server,让 MCP 通过 HTTP 转发任务。

启动 relay:

cd /path/to/mcp-dev-tools
CLAUDE_RELAY_TOKEN=<shared-secret> npm run claude-relay

默认监听 http://127.0.0.1:38765。如果客户端不能访问 127.0.0.1,可以显式设置:

CLAUDE_RELAY_HOST=<reachable-host>
CLAUDE_RELAY_PORT=38765
CLAUDE_RELAY_TOKEN=<shared-secret>
npm run claude-relay

MCP server 侧配置:

CLAUDE_EXEC_MODE=relay
CLAUDE_RELAY_URL=http://<reachable-host>:38765
CLAUDE_RELAY_TOKEN=<shared-secret>

安全提醒:不要在无 token 的情况下把 relay 绑定到局域网地址或 0.0.0.0


客户端配置

选择你使用的客户端,复制命令到终端执行。执行前先替换 <...> 占位符为你自己的值。

路径示例:如果你 clone 到了 ~/mcp-dev-tools,那绝对路径就是 /Users/yourname/mcp-dev-tools/src/index.js,macOS 下可以通过 pwd 命令查看。

Claude Code

claude mcp add dev-tools \
  -e GITHUB_TOKEN=<your-github-token> \
  -e GITLAB_TOKEN=<your-gitlab-token> \
  -e GITLAB_URL=https://gitlab.com \
  -e FIGMA_TOKEN=<your-figma-token> \
  -- node <绝对路径>/mcp-dev-tools/src/index.js

VS Code (GitHub Copilot)

在项目根目录执行:

mkdir -p .vscode
cat > .vscode/mcp.json << 'EOF'
{
  "servers": {
    "dev-tools": {
      "type": "stdio",
      "command": "node",
      "args": ["<绝对路径>/mcp-dev-tools/src/index.js"],
      "env": {
        "GITHUB_TOKEN": "<your-github-token>",
        "GITLAB_TOKEN": "<your-gitlab-token>",
        "GITLAB_URL": "https://gitlab.com",
        "FIGMA_TOKEN": "<your-figma-token>"
      }
    }
  }
}
EOF

Codex CLI

mkdir -p ~/.codex
cat >> ~/.codex/config.toml << 'EOF'

[mcp_servers.dev-tools]
command = "node"
args = ["<绝对路径>/mcp-dev-tools/src/index.js"]
env = { "GITHUB_TOKEN" = "<your-github-token>", "GITLAB_TOKEN" = "<your-gitlab-token>", "GITLAB_URL" = "https://gitlab.com", "FIGMA_TOKEN" = "<your-figma-token>" }
EOF

Kiro / Cursor

这两个客户端格式相同,区别只在配置文件路径:

客户端

配置文件路径

Kiro(全局)

~/.kiro/settings/mcp.json

Kiro(工作区)

.kiro/settings/mcp.json

Cursor

~/.cursor/mcp.json

配置内容(以 Kiro 全局为例):

mkdir -p ~/.kiro/settings
cat > ~/.kiro/settings/mcp.json << 'EOF'
{
  "mcpServers": {
    "dev-tools": {
      "command": "node",
      "args": ["<绝对路径>/mcp-dev-tools/src/index.js"],
      "env": {
        "GITHUB_TOKEN": "<your-github-token>",
        "GITLAB_TOKEN": "<your-gitlab-token>",
        "GITLAB_URL": "https://gitlab.com",
        "FIGMA_TOKEN": "<your-figma-token>"
      }
    }
  }
}
EOF

Cursor 只需把路径改为 ~/.cursor/mcp.json


项目结构

mcp-dev-tools/
├── src/
│   ├── index.js      # 入口,启动 MCP Server
│   ├── tools.js      # 工具注册
│   ├── github.js     # GitHub API 封装
│   ├── gitlab.js     # GitLab API 封装
│   └── figma.js      # Figma API 封装
├── .env.example
├── .gitignore
├── package.json
└── README.md

使用示例

配置好后,在聊天中直接说:

  • "帮我看看 github 上 facebook/react 的 package.json"

  • "列出 gitlab 项目 mygroup/myproject 的 src 目录"

  • "看一下这个 Figma 设计稿的节点树:https://www.figma.com/design/xxx"

  • "提取这个 Figma 页面里的所有文字内容"

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    F
    maintenance
    Provides unified access to multiple CLI AI agents (Codex, Gemini, Claude, and OpenCode) through a single MCP interface with real-time task monitoring, enabling specialized code analysis, UI design, implementation, and prototyping workflows.
    11
    21
    MIT
  • A
    license
    B
    quality
    F
    maintenance
    Enables orchestrating multiple AI CLI agents (Claude Code, Codex, Gemini CLI, Copilot CLI) through a unified MCP interface for task delegation, cross-agent comparison, and specialized tools like code review and debugging.
    14
    4 npm
    14
    MIT