新闻详情

新闻详情

首页 / 资讯中心 / 详情

如何为 AtomCode 接入 MCP 服务器:外部工具扩展完整教程

发布时间:2026/11/18 9:53:43来源:尧图网络
如何为 AtomCode 接入 MCP 服务器:外部工具扩展完整教程
如何为 AtomCode 接入 MCP 服务器外部工具扩展完整教程【免费下载链接】atomcodeClaude Code 的开源替代方案。连接任意大模型编辑代码运行命令自动验证 — 全自动执行。用 Rust 构建极致性能。 An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get Started项目地址: https://gitcode.com/atomgit_atomcode/atomcodeAtomCode 是用 Rust 构建的开源 AI 编程智能体自 v4.20.4 起内置 MCPModel Context Protocol客户端。你可以为 AtomCode 接入任意 MCP 服务器 —— 代码托管、数据库、浏览器自动化、Slack 等外部工具 —— 让模型像调用 AtomCode 内置工具一样使用它们。本文带你完整走完为 AtomCode 接入 MCP 服务器的全流程从一行命令快速添加到远程 HTTP 服务、项目信任、审批放行与故障排查。一、接入 MCP 服务器后AtomCode 能做什么使用场景典型 MCP server代码协作GitHub / GitLab查 issue、建 PR数据库Postgres / MySQL / DuckDB 查询服务浏览器自动化Playwright团队服务Slack、Notion、Jira 等远程端点内部工具把团队领域工具暴露给模型无需改 AtomCode 源码接入后远端工具会统一注册为mcp__server键名__工具名格式的工具名并走与内建工具一致的审批链路。二、两个配置位置项目级 vs 用户全局AtomCode 支持两个配置文件可同时存在同名 server 以项目级为准覆盖用户级路径作用域适合场景项目根/.mcp.json仅当前项目跟仓库一起共享给团队~/.atomcode/mcp.json用户全局跨所有项目个人常用工具仓库根目录附带模板 .mcp.json.example内含 stdio 与 HTTP 两套完整示例和详细注释复制后重命名为.mcp.json即可开始。配置文件支持JSONC 注释//行注释、/* */块注释方便临时注释掉某个 server 而不用删除。三、最快方式一行命令添加 stdio MCP 服务器如果 server 是本地子进程不需要手写 JSONatomcode mcp add一步完成# 写入当前项目根 .mcp.json默认 atomcode mcp add playwright npx playwright/mcplatest # 写入用户全局 ~/.atomcode/mcp.json atomcode mcp add playwright npx -y playwright/mcplatest --global # 指定项目目录 atomcode mcp add playwright npx playwright/mcplatest -C /path/to/repo第一个参数是server 键名会出现在工具名里其余整串是可执行文件 参数。同名 server 会整段覆盖原有配置env等字段不保留。add只支持 stdio 类型HTTP 服务需手写配置。四、手写 .mcp.jsonstdio 与 HTTP 两种传输顶层键固定为mcpServers旧键servers仍兼容。每个 server 只写一种传输不要同时写command和url。stdio本地子进程示例{ mcpServers: { filesystem: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, /tmp], env: { NODE_ENV: production }, timeout_ms: 10000 } } }HTTP远程端点示例{ mcpServers: { notion: { url: https://mcp.example.com/notion/mcp, headers: { Authorization: Bearer ${NOTION_TOKEN} }, timeout_ms: 30000 } } }常用配置字段一览字段适用说明command/args/envstdio可执行文件、参数、子进程环境变量url/headersHTTP端点地址、自定义请求头authHTTPOAuth 或 Bearer 鉴权timeout_ms两者单请求超时默认 30000disabled两者置true可临时停用该 servertrust/autoApprove两者免审批见第八节 字符串支持${VAR}与${VAR:-默认值}环境变量展开敏感令牌不要写死在文件里。两个易踩的小坑尾逗号仍然非法只是容忍注释并非 JSON5文件中若保留了注释mcp add为避免抹掉注释会拒绝改写并报错请手动编辑。五、接入远程 OAuth 服务可选进阶需要 OAuth 登录的远程服务有专用命令入口以 GitHub Remote MCP 为例atomcode mcp add-github-oauth github --global # 只写配置不登录 atomcode mcp login github --client-secret-env GITHUB_MCP_CLIENT_SECRET atomcode mcp logout github # 删除已存凭证TUI 中等价命令为/mcp login server与/mcp logout server。token 保存在~/.atomcode/mcp_auth.toml权限 0600后续 HTTP 请求自动附加Authorization: Bearer过期且有 refresh token 时自动刷新。后台连接不会自动弹浏览器必须显式登录。OAuth App 注册细节与完整配置见 docs/mcp/github.md。六、项目信任最容易漏掉的一步 ⚠️项目级.mcp.json里的 server在未信任的项目中根本不会连接状态显示blocked: untrusted project。这个 fail-closed 设计保证刚 clone 下来、自带.mcp.json的仓库不会在你机器上自动拉起子进程。用户全局配置~/.atomcode/mcp.json不受此限。/mcp trust # 信任当前项目立即连接无需重启 /mcp untrust # 撤销信任该项目 MCP 工具立即移除信任记录存于~/.atomcode/mcp_trust.json按项目目录记录。七、查看连接状态/mcp 命令全家桶改完配置不用重启 AtomCodeTUI 里执行/mcp reload即可重新读取两份配置并后台重连。命令作用/mcp列出所有 server 及状态含failed/blocked/mcp reload重载配置并后台重连/mcp tools server列出该 server 实际暴露的远端工具/mcp login server//mcp logout serverOAuth 登录 / 清除凭证/mcp trust//mcp untrust信任 / 取消信任当前项目会话区会显示✓ MCP server github connected或✗ MCP server … failed: …。单个 server 失败不会拖垮主程序失败保留在列表里可随时/mcp reload重试。远端工具统一注册为mcp__server键名__远端工具名。例如键名是github、远端有get_issue工具名即mcp__github__get_issue。也可以用这个完整名禁用指定工具atomcode --disable-tools mcp__github__get_issue八、审批与安全MCP 工具免审批的三条路MCP server 是外部代码工具默认标记为有风险每次调用都需审批。模型调用时你可以选择Y— 允许这一次A— 当前会话内放行重启后失效不持久化N— 拒绝想长期放行有三条路方式作用范围配置位置trust: true整个 server 免审批server 配置项内autoApprove: [search]按工具名白名单免审批server 配置项内运行时审批选 Always自动写回 autoApprove审批弹窗 安全提示把 MCP 工具返回的内容当作不可信数据不要让它升级成系统指令。对写操作工具建分支、改文件、发评论建议保留审批。九、常见问题快速自查现象原因解决办法blocked: untrusted project项目未信任TUI 执行/mcp trustfailed: ...命令有误或进程不可用检查command/args再/mcp reloadtools/list timed out远程 server 首次发现慢调大该 server 的timeout_ms如 60000server 不生效条目被停用检查disabled: true改为falsemcp server not found in config配置里没有该 server先执行atomcode mcp add …写入 想先验证连通性仓库内置mcp-test-server源码 crates/atomcode-capabilities/src/bin/mcp-test-server.rs编译后配置它即可在对话中调用echo工具验证整条链路。十、MCP 功能源码在哪里MCP 客户端实现位于 crates/atomcode-capabilities/src/mcp/模块分工清晰config.rs负责配置解析与两级合并registry.rs负责后台并行连接与工具路由transport_stdio.rs/transport_http.rs对应两种传输oauth.rs处理登录与 token 刷新trust.rs管理项目信任tool.rs是远端工具到内核工具的适配层。协议细节修订协商、会话管理、断线重连等完整说明见 docs/mcp.md。总结三步接入 MCP 服务器添加—atomcode mcp add 键名 命令最快或手写.mcp.json信任— TUI 执行/mcp trust仅项目级配置需要验证—/mcp查看连接状态/mcp tools server查看工具列表完成后模型即可自主查询代码仓库、数据库、浏览器等外部能力 —— 全程无需修改 AtomCode 源码。【免费下载链接】atomcodeClaude Code 的开源替代方案。连接任意大模型编辑代码运行命令自动验证 — 全自动执行。用 Rust 构建极致性能。 An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get Started项目地址: https://gitcode.com/atomgit_atomcode/atomcode创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/17 7:04:08

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/17 5:42:44

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/17 19:43:34

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/17 6:55:04

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/17 5:57:47

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/17 19:43:32

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉