Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

codebuddy: project-scope MCP written to .codebuddy/mcp.json instead of .mcp.json (mcpProject unused)

Open
  • Is something wrong?
#1,185 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
Half a day
Newbie friendliness
62/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript
Domain
cli

Research direction

The report points at the codebuddy entry in the toolPaths table, which defines both mcp (.codebuddy/mcp.json) and mcpProject (.mcp.json), so start by finding where the MCP write path is chosen by scope. The shipped dist/cli.js is minified, so the source file that builds this table is the place to read first. Done means project and workspace scope write to .mcp.json for codebuddy, user scope is unchanged, and a regression test like the existing claude one covers it.

Written by the indexing model from the issue text.

Description

teamai CLI 反馈：codebuddy 项目级 MCP 落盘到错误路径

环境

  • teamai-cli 0.28.0-beta.4（npm i -g teamai-cli）
  • CodeBuddy Code（@tencent-ai/codebuddy-code）
  • 复现目录：一个 teamai workspace-scope 初始化的项目

问题（TL;DR）

teamai 的 codebuddy 分支未使用 mcpProject 字段，把 project-scope MCP 写到了
<项目根>/.codebuddy/mcp.json，而 CodeBuddy 只读 <项目根>/.mcp.json。

这是 teamai 的 bug（非 CodeBuddy）。结果：所有项目级 MCP server
（context7 / graphify / postgresql-service 等）都不会被加载——/mcp 只显示 user 级
server，项目级一个都不出现，且无任何报错，极难排查。

复现步骤
  1. teamai init <team-repo> --agent codebuddy（workspace/project scope 均可）
  2. 团队成员确认 MCP 已声明（teamai mcp list 显示 installed: codebuddy）
  3. 文件确实写到了 <项目根>/.codebuddy/mcp.json（内容正确）
  4. 但 CodeBuddy /mcp 里 看不到 这些 server
  5. 执行 ln -sf .codebuddy/mcp.json .mcp.json 后，重启 CodeBuddy →
    /mcp 立即列出全部三个 project server
证据

CodeBuddy 官方文档 cn/cli/mcp.md「PROJECT 作用域」明确：

优先级顺序（从高到低）：
1. <项目根目录>/.mcp.json   （推荐）
2. <项目根目录>/mcp.json    （已废弃）

而 teamai dist/cli.js 中 codebuddy 的 toolPaths 其实已经定义了正确字段：

codebuddy: {
  skills: ".codebuddy/skills",
  rules: ".codebuddy/rules",
  settings: ".codebuddy/settings.json",
  claudemd: ".codebuddy/CODEBUDDY.md",
  agents: ".codebuddy/agents",
  mcp: ".codebuddy/mcp.json",      // ← 实际写入用的是这个（user-scope 语义）
  mcpProject: ".mcp.json"          // ← project-scope 应使用这个，但未被选用
}

对比 claude / cursor 也都同时定义了 mcp 与 mcpProject 两个字段，
说明 mcpProject 是设计内的 project-scope 路径。

责任归属：这是 teamai 的 bug，不是 CodeBuddy 的

请明确：不要在 CodeBuddy 侧修复，也不应请求 CodeBuddy 去读 .codebuddy/mcp.json。

  • CodeBuddy 只读 <项目根>/.mcp.json 是其公开文档契约，且 .mcp.json 是主流
    AI 编码工具（Claude Code 等）通用的项目级 MCP 文件名。CodeBuddy 行为正确、无 bug。
  • teamai 的 toolPaths 里已经存在正确的 project-scope 字段 mcpProject: ".mcp.json"
    （与 claude / cursor 完全并列定义），但 codebuddy 分支在写入 project-scope MCP 时
    没有选用它，而是误用了 user-scope 的 mcp 字段    ，导致文件落到 CodeBuddy 不读的
    .codebuddy/mcp.json。

一句话：teamai 的 codebuddy 分支未使用 mcpProject 字段 —— 这是根因。

期望修复

teamai 写入 project-scope MCP 时（scope 为 project / workspace），
codebuddy 分支应选用 mcpProject（即 <项目根>/.mcp.json），而非 mcp。

  • 修复点集中在「按 scope 选择 MCP 配置文件路径」的那段逻辑；
    由于 mcpProject 字段已在 toolPaths 中就绪，改动量应很小。
  • 建议同时补一个回归测试：对 codebuddy，project/workspace scope 下 MCP 必须落到
    .mcp.json（可参考 claude 的同类测试）。
  • 我未能精确定位到做出该选择的代码行（发布包 dist/cli.js 为压缩产物），
    以上为可复现的行为证据 + 字段已存在的代码证据；据此应能快速定位。

临时绕过

受影响成员可自行：ln -sf .codebuddy/mcp.json .mcp.json
（.mcp.json 通常在 .gitignore 中，且软链能跟随后续 teamai pull 的更新）

附：同类问题（顺带反馈，可另开 issue）

teamai 分发的 MCP server 在 uvx 下易因依赖漂移而启动即崩（已在本团队 PR 修复，
但建议 teamai 侧在文档/模板中提示）：

  1. 用 mcp.server.fastmcp 的 Python MCP 包（postgres-mcp、mcp-server-mysql 等）
    在 mcp SDK v2 下会 ModuleNotFoundError: No module named 'mcp.server.fastmcp'
    （v2 把 FastMCP 改名 MCPServer）→ 需 --with mcp<2
  2. graphifyy 基础包不含 mcp 模块 → 需 --from graphifyy[mcp]
  3. mcp-server-mysql 只读环境变量 MYSQL_*，不认 --host/--port/... 命令行参数
Dominant language
TypeScript
Stars
5.5k
Forks
443
Avg merge
21h 38m
Merged PRs (30d)
347

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Tencent/teamai-cli

All issues in Tencent/teamai-cli

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.