mcp-docs

MarkdownドキュメントをLLMに公開し、あらゆるソフトウェアドキュメントに関する検索や質問への回答を可能にする汎用MCPサーバー。

サーバーのアイデンティティ（名前、指示、カテゴリラベル）は、完全に docs/ ディレクトリ（このリポジトリと並行してクローンされる別のリポジトリ）によって決定されます。

要件

• Python 3.14+

• uv

セットアップ

1. ドキュメントリポジトリのクローン

サーバーを起動する前に docs/ ディレクトリが存在している必要があります。ドキュメントリポジトリをその中にクローンしてください：

git clone <docs-repo-url> docs

2. 依存関係のインストール

uv sync

docs/ ディレクトリ構造

サーバーはサブディレクトリからカテゴリを自動的に検出します。必須ファイルは docs/ のルートにある config.toml のみです。

docs/
├── config.toml          # required — project identity
├── <category>/
│   ├── <topic>.md
│   └── ...
└── <category>/
    └── ...

config.toml

[project]
name = "my-project"
instructions = """
System instructions for the LLM. Describe what this documentation covers
and how the model should use the available tools.
"""

[categories]
folder-name = "Human-readable label"

• [project] は必須です。name はサーバーを識別し、instructions はLLMをガイドします。

• [categories] はオプションです。リストされていないサブディレクトリには、自動的にタイトルケースのラベルが付けられます（my-folder → My Folder）。

• img/ サブディレクトリ内のファイルは提供されません。

使用方法

サーバーの実行（stdioモード）

uv run main.py

MCP Inspectorによる開発

uv run mcp dev main.py

ブラウザでMCP Inspectorを開きます。実行中のSSEまたはStreamable HTTPサーバーに接続するには、先にサーバーを起動し、表示されたエンドポイントをインスペクターに指定してください：

uv run main.py --transport sse
uv run main.py --transport streamable-http

Claude Desktopでの設定

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) に追加してください：

{
  "mcpServers": {
    "my-project": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-docs", "run", "main.py"]
    }
  }
}

Claude Codeでの設定

claude mcp add my-project -- uv --directory /path/to/mcp-docs run main.py

機能

ツール

リソース