BaseMcpServer

BaseMcpServer

MCP（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

このリポジトリにある各サーバーは、mcp-manager install でインストールできる Python パッケージです。それぞれに専用の 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

Atlassian API トークンの設定を含む、jira-helper の最初から最後までの手順については、QUICKSTART.md を参照してください。

新しい MCP サーバーの構築

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 License