Codebeamer MCP

码流器mcp

用于Codebeamer ALM的MCP（模型上下文协议）服务器。允许Claude和其他MCP客户端使用自然语言在Codebeamer中读写项目、跟踪器和项目。


工具（19）

阅读

写

安装

需求

• Node.js 20+
• 访问Codebeamer实例（URL、用户名、密码）

克劳德代码（CLI）

最快的方法是在终端中运行此命令：

claude mcp add codebeamer -e CB_URL=https://your-instance.example.com/cb/api \
  -e CB_USERNAME=your_username -e CB_PASSWORD=your_password \
  -- npx -y codebeamer-mcp

或手动添加到 .mcp.json 在项目根目录中（或 ~/.claude/mcp.json 全球范围）：

{
  "mcpServers": {
    "codebeamer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

克劳德桌面版

编辑您平台的配置文件：

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

保存后重新启动Claude Desktop。

光标

增添 .cursor/mcp.json 在项目根（项目范围）中或 ~/.cursor/mcp.json （全球）：

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

帆板运动

增添 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

VS代码（副本）

增添 .vscode/mcp.json 在项目根目录中：

{
  "servers": {
    "codebeamer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Gemini CLI

增添 ~/.gemini/settings.json:

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

替代方案：全局安装

npm install -g codebeamer-mcp

然后使用 "command": "codebeamer-mcp" （没有 args)而不是 npx 在上面的任何配置中。

固定特定版本

"args": ["-y", "codebeamer-mcp@0.2.0"]

更新

⚠️ 永不承诺 .mcp.json 持有真实证件 --它列在 .gitignore.

来源（开发）

git clone https://github.com/3KniGHtcZ/codebeamer-mcp.git
cd codebeamer-mcp
npm install
npm run build

然后使用 "command": "node" 和 "args": ["dist/index.js"] 在你的 .mcp.json.

开发与测试

# Run tests (no real Codebeamer instance needed)
npm test

# Start the mock API server (port 3001)
node mock-server.mjs

# Interactive testing via MCP Inspector
CB_URL=http://localhost:3001 CB_USERNAME=mock CB_PASSWORD=mock \
  npx @modelcontextprotocol/inspector node dist/index.js

配置