BaseMcpServer

BaseMcpServer

一个 Model Context Protocol 服务的单体仓库，以及用于安装和配置这些服务的 mcp-manager CLI。

此仓库包含什么

BaseMcpServer/
├── utils/mcp_manager/         # CLI for installing + managing MCP servers (canonical install path)
├── servers/
│   ├── jira-helper/           # Jira + Confluence integration server (multi-instance)
│   ├── worldcontext/          # Current-context tools (date/time, market, news, dev-tool versions)
│   ├── mcpservercreator/      # Generator that scaffolds new MCP servers from a code snippet
│   ├── loadbearing-youtube/   # Extract a YouTube transcript + expose its load-bearing components
│   └── template/              # Starter scaffold to fork when building a new server
├── docs/
│   ├── adr/                   # Architecture Decision Records
│   ├── developer/             # Implementation guides (build a new MCP server, client support, etc.)
│   └── user/                  # End-user docs (Cline compatibility, etc.)
└── QUICKSTART.md              # End-to-end jira-helper onboarding

此仓库中的每个服务都是一个 Python 包，可通过 mcp-manager install 安装。每个包都有自己的隔离环境，由 uv 管理，位于 ~/.config/mcp-manager/servers/<name>/.venv 下，并可通过一次 mcp-manager sync 调用接入受支持的 MCP 客户端。此仓库目前支持并测试 macOS 和 Linux；明确不支持 Windows。

快速安装

# 1. One-time: install uv and mcp-manager
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install "git+https://github.com/dawsonlp/BaseMcpServer.git#subdirectory=utils/mcp_manager"
uv tool update-shell

# 2. Install whichever servers you want
mcp-manager install jira-helper        --source ./servers/jira-helper
mcp-manager install worldcontext       --source ./servers/worldcontext
mcp-manager install mcpservercreator   --source ./servers/mcpservercreator
mcp-manager install loadbearing-youtube --source ./servers/loadbearing-youtube

# 3. Edit the per-server config files (where credentials go) — see each server's README
$EDITOR ~/.config/mcp-manager/servers/jira-helper/config.yaml

# 4. Wire the servers into installed supported clients
mcp-manager sync

如需查看 jira-helper 的端到端操作指南（包括 Atlassian API 令牌设置），请参阅 QUICKSTART.md。

构建新的 MCP 服务

Fork servers/template/，并按照其中的 README 操作。每个服务都直接使用 MCP Python SDK v2：通过 create_server() 工厂函数构建 MCPServer，然后通过 add_tool() 注册普通工具函数。此处不使用基于装饰器的注册方式，也不使用 MCP Commons。

详细参考： docs/developer/BUILD_A_NEW_MCP.md。

如需从代码片段动态生成服务，请参阅安装后的 mcpservercreator 服务。

连接客户端

mcp-manager sync      # sync every detected supported client
# or selectively:
mcp-manager sync --platform cline
mcp-manager sync --platform codex

mcp-manager 支持 Cline、Claude Desktop、Claude Code、VS Code 原生 MCP、Codex 和 Antigravity。它会写入或委托写入 stdio 条目，这些条目指向各服务托管环境中的可执行文件。重启受影响的客户端，使新条目生效。

条目示例（自动写入，仅供参考）：

{
  "mcpServers": {
    "jira-helper": {
      "command": "/Users/<you>/.config/mcp-manager/servers/jira-helper/.venv/bin/jira-helper",
      "args": ["stdio"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

在编辑器设置文件中手动添加的条目会在 sync 后保留——只有与 mcp-manager 注册表中服务名称匹配的条目才会被覆盖。

架构决策

主要方向性选择记录在 docs/adr/ 下：

• ADR-003 — 当前方案：所有服务都通过 uv 安装
• ADR-002 — 已被取代；记录了早期尝试将 pipx 设为默认方案的过程

许可证

MIT 许可证