【免费下载链接】claude-code-base-actionThis repo is a mirror of the contents of base-action in https://github.com/anthropics/claude-code-action.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-base-action点击查看免费下载claude-code-base-action 是一个用于在 CI 工作流中运行 Claude Code 的 GitHub Action它原生支持通过 MCPModel Context Protocol配置接入 GitHub、自定义服务等外部工具让 AI 在流水线中读写 Issue、查询 API、执行跨系统集成而不必手写胶水代码。本文带你用最短的步骤完成claude-code-base-action 接入 MCP Server并覆盖配置文件两种方式、MCP 工具权限白名单、GitHub 集成示例与本地调试方法。claude-code-base-action 是什么它是一个薄封装在 CI 环境中安装并运行 Claude Code把你在 workflow 里传入的 prompt、参数和凭证交给它执行。动作定义action.yml入口逻辑src/index.ts运行实现src/run-claude.ts、src/run-claude-sdk.ts对 MCP 而言核心通道只有一个claude_args输入项它会把参数原样透传给 Claude CLI其中就包括--mcp-config。参数解析逻辑见 src/parse-sdk-options.ts。MCP 配置两种方式方式一传入 MCP 配置文件路径把 MCP 配置写成 JSON 文件再用--mcp-config指定路径- name: Run Claude Code with MCP config file uses: anthropics/claude-code-base-actionbeta with: prompt: Your prompt here claude_args: | --mcp-config path/to/mcp-config.json --allowedTools Bash(git:*),Read,Glob,Grep anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}配置文件的标准格式如下mcpServers下每个 key 就是一个服务器{ mcpServers: { server-name: { command: node, args: [./server.js], env: { API_KEY: your-api-key } } } }方式二内联 MCP 配置无需额外文件直接把 JSON 字符串写在claude_args里适合不想多维护一个配置文件的场景claude_args: - --mcp-config {mcpServers:{server-name:{command:node,args:[./server.js]}}} --allowedTools Bash(git:*),Read,Glob,Grep两种配置可以共存action 会把多次出现的--mcp-config自动合并成一个配置内联 JSON 合并mcpServers对象文件路径保持原样合并逻辑在 src/parse-sdk-options.ts 的mergeMcpConfigs中。给 MCP 工具加权限白名单Claude Code 的 MCP 工具遵循统一命名规则mcp__服务器名__工具名例如服务器server-name暴露了custom_tool那么在--allowedTools中这样放行claude_args: | --mcp-config mcp-config.json --allowedTools Bash(git:*),Read,mcp__server-name__custom_tool⚠️ 注意不写--allowedTools时 MCP 工具不会被自动放行这是有意的安全设计——只给你真正需要的工具开权限。测试用例可以查看 test/parse-sdk-options.test.ts。另外action 会始终将enableAllProjectMcpServers设为true保证项目目录下的.mcp.json配置也能正常生效见 README.md Using Settings Configuration 一节。实战连接 GitHub MCP Server仓库内置了一个完整的 Issue 分诊示例通过 Docker 启动 GitHub 官方 MCP Server让 Claude 自动给新 Issue 打标签示例工作流examples/issue-triage.yml触发条件issues事件新 Issue 打开时关键步骤先用mkdircat生成 MCP 配置文件到/tmp/mcp-config/再把路径传给--mcp-config凭证管理GITHUB_PERSONAL_ACCESS_TOKEN从${{ secrets.GITHUB_TOKEN }}注入绝不硬编码这个示例同时演示了 MCP 配置的两种常见使用姿势运行时动态生成配置文件与secrets 安全注入。本地调试 MCPtest-mcp-local.sh不想每次都推 GitHub 看结果仓库提供了本地调试脚本调试脚本test-mcp-local.sh —— 使用act在本地容器运行工作流需要先export ANTHROPIC_API_KEY示例 MCP Servertest/mcp-test/simple-mcp-server.ts —— 基于modelcontextprotocol/sdk通过 stdio 传输暴露了一个test_tool是最小可运行的 MCP 服务器模板依赖定义test/mcp-test/package.json上手路径建议把simple-mcp-server.ts作为起点替换成你自己的工具逻辑再用脚本反复验证最后把工作流推到仓库。常用文件路径速查内容路径Action 输入输出定义action.ymlMCP 配置解析与合并src/parse-sdk-options.tsMCP 参数透传入口src/index.tsSDK 执行与日志输出src/run-claude-sdk.tsGitHub MCP 集成示例examples/issue-triage.yml本地 MCP 测试脚本test-mcp-local.sh最小 MCP Server 示例test/mcp-test/simple-mcp-server.ts安全与最佳实践密钥一律走 secretsMCP 配置的env中引用${{ secrets.XXX }}不要把 API key 写进配置文件最小权限--allowedTools只放行需要的 MCP 工具而非mcp__server__*全量放行先本地后云端用 test-mcp-local.sh 验证 MCP 服务器连通性后再推工作流保留执行日志通过输出项execution_file可拿到完整 JSON 执行日志便于排查 MCP 工具调用问题见 action.yml 的 outputs 定义完成以上步骤后你的 CI 流水线里的 Claude Code 就能像本地一样调用 GitHub、数据库或任意自定义工具了——把重复的胶水工作交给 MCP把精力留给业务逻辑。赞分享【免费下载链接】claude-code-base-actionThis repo is a mirror of the contents of base-action in https://github.com/anthropics/claude-code-action.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-base-action点击查看免费下载相关推荐如何把 Ant Design 官方 MCP Server 接入 Cursor、Claude Code 等 IDE 工具如何把 Ant Design 官方 MCP Server 接入 Cursor、Claude Code 等 IDE 工具 当你用 Cursor、Claude Co前端UI组件设计系统OpenPencil MCP Server 接入指南让 Claude Code、Cursor 等 AI 编程工具读写设计稿OpenPencil MCP Server 接入指南让 Claude Code、Cursor 等 AI 编程工具读写设计稿 OpenPencil 内置了一个基前端桌面应用AI 应用MCP 服务ComfyUI-WanVideoWrapper 实操避坑指南8GB显存跑通14B从装到出长视频ComfyUI WanVideoWrapper 实操避坑指南8GB显存跑通14B从装到出长视频 ComfyUI WanVideoWrapper 是一个把 W人工智能大模型媒体生成视频创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考