Skip to main content
Glama

mcp-docs

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

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

要件

  • Python 3.14+

  • uv

Related MCP server: repocks

セットアップ

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

機能

ツール

ツール

説明

list_docs(category?)

利用可能なドキュメントファイルの一覧を表示(カテゴリによるフィルタリングが可能)

read_doc(category, topic)

ドキュメントファイルの全内容を読み取る

search_docs(query, category?)

すべてのドキュメントを対象とした全文検索

リソース

URI

説明

docs://index

利用可能なすべてのドキュメントファイルの完全インデックス

docs://{category}/{topic}

特定のドキュメントファイルの内容

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context
    20 npm
    264
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Transforms Markdown documentation into an intelligent knowledge base with AI-powered search and Q\&A through an MCP server.
    20 npm
    9
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that indexes documents and serves relevant context to LLMs via Retrieval Augmented Generation (RAG).
    21 npm
    36
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    A documentation MCP server that crawls websites and Git repositories, stores them as Markdown, and provides tools to search and retrieve documentation for local LLMs and AI agents.
    Apache 2.0