@tiberriver256/docs-to-mcp-cli

@tiberriver256/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 を参照してください。