docs-to-mcp-cli

docs-to-mcp-cli

Markdown ドキュメントを特定のツール経由で公開する、自己完結型で実行可能な MCP（Model Context Protocol）サーバーを生成する CLI ツールです。

MCP とは？

Model Context Protocol（MCP）は、AI アシスタントが外部のツールやデータソースにアクセスできるようにするオープン標準です。ドキュメントを MCP サーバーに変換することで、AI アシスタントは次のことができるようになります。

• ドキュメントを閲覧する
• 特定の情報を検索する
• 任意のドキュメントの全内容にアクセスする
• ドキュメントを活用して、より正確で文脈に即した応答を提供する

インストール

ツールはグローバルにインストールできます。

npm install -g @tiberriver256/docs-to-mcp-cli

または、npx を使って直接実行できます。

npx @tiberriver256/docs-to-mcp-cli --docs "path/to/docs/**/*.md" --packageName MyDocsServer

使い方

docs-to-mcp-cli --docs <pattern> --packageName <n> [--outDir <dir>] [--toolName <name>]

オプション

• -d, --docs <pattern>：Markdown ファイルの Glob パターン（必須）
• -p, --packageName <n>：生成する MCP サーバーの名前（必須）
• -o, --outDir <dir>：バンドルされたサーバーの出力ディレクトリ（デフォルト："dist"）
• -t, --toolName <name>：ドキュメントの対象となるツール／パッケージ／ライブラリの名前（ツールの説明で使用）
• -v, --version：現在のバージョンを出力

例

# Generate a server from all markdown files in the docs directory
docs-to-mcp-cli --docs "docs/**/*.md" --packageName ProjectDocs

# Specify a custom tool name and output directory
docs-to-mcp-cli --docs "documentation/**/*.md" --packageName APIDocsServer --toolName "My API" --outDir build

# Run the generated server
node dist/index.js

生成されるサーバーのツール

生成された MCP サーバーは、AI アシスタントに次のツールを提供します。

• list_docs：利用可能なすべてのドキュメントを、内容のプレビューとともに一覧表示します
• get_doc：パスで指定したドキュメントの全内容を取得します
• search_docs：あいまい検索を使って、すべてのドキュメントを対象に検索します

AI アシスタントとの連携

MCP サーバーを起動すると、Model Context Protocol に対応した AI アシスタントがサーバーに接続し、ドキュメントにアクセスできるようになります。これにより、AI は個別のドキュメントに基づいて、より正確で文脈に即した応答を提供できます。

開発

CLI ツールをローカルでビルドするには、次のコマンドを実行します。

# Clone the repository
git clone https://github.com/Tiberriver256/docs-to-mcp-cli.git
cd docs-to-mcp-cli

# Install dependencies
npm install

# Build the project
npm run build

# Link for local development
npm link

現在のバージョン

現在のバージョンは 1.1.2 です。最近の更新の詳細については、CHANGELOG.mdを参照してください。