My Docs MCP Server

🚀 私のドキュメントMCPサーバー

このMCPサーバーは、指定されたディレクトリ内のすべてのMarkdown（.md）ファイルの全文をインデックス化し、MCPプロトコルを通じて検索とアクセス機能を提供します。

🚀 クイックスタート

このMCPサーバーは、指定されたディレクトリ内のMarkdown（.md）ファイルの全文をインデックス化し、MCPプロトコルを通じて検索とアクセス機能を提供します。

• MCPのtoolsとして全文検索（search_docs）を提供します。
• MCPのresourcesとしてファイル全文取得（read_doc）を提供します。
• TypeScriptで開発されています。

✨ 主な機能

• MCPのtoolsとして全文検索（search_docs）を提供します。
• MCPのresourcesとしてファイル全文取得（read_doc）を提供します。

🔧 技術詳細

• TypeScript：サーバー本体の実装言語です。
• @modelcontextprotocol/sdk：MCPプロトコルの通信とプロトコル実装に使用されます。
• MiniSearch：Markdownファイルの全文インデックス作成と検索に使用され、軽量かつ効率的です。
• wakachigaki：日本語テキストの分かち書き（Tokenization）ライブラリで、MiniSearchの分かち書き器として使用され、日本語検索精度を大幅に向上させます。
• fast-glob：docsディレクトリ内のMarkdownファイルを再帰的に走査します。
• Node.js標準のfs/promises、pathモジュール：ファイルの読み取りとパス操作に使用されます。
• Stdioサーバー：標準入出力を通じてMCPクライアント（Claude DesktopやInspectorなど）と通信します。

📦 インストール

環境構築

1. 依存パッケージをインストールします。

npm install

2. docsディレクトリを作成し、Markdownファイルを配置します。

mkdir docs
# 例：テストファイルを作成
echo "# テスト\nこれはテスト内容です。" > docs/テスト.md

3. TypeScriptをビルドします。

npm run build

サーバーの起動方法

開発モード（TypeScriptを直接実行）

npm run dev -- [docsディレクトリのパス]
# 例：npm run dev -- ./docs

本番環境（ビルド済みのファイルを使用）

npm start -- [docsディレクトリのパス]
# 例：npm start -- ./docs

• docsディレクトリのパスはオプションで、デフォルトはdocs/です。

💻 使用例

基本的な使用法

MCP Inspectorでのテスト

MCP Inspectorを使用すると、GUIでサーバーのツールとサービスリソースをテストできます。

npm run inspect -- [docsディレクトリのパス]
# 例：npm run inspect -- ./docs

または、ビルド済みのファイルを使用する場合は：

npx -y @modelcontextprotocol/inspector node build/index.js ./docs

Claude Desktopでの使用例

1. Claude Desktopの設定ファイル（例：~/Library/Application Support/Claude/claude_desktop_config.json）を開き、以下のサーバー設定を追加します。

{
  "mcpServers": {
    "ドキュメント検索": {
      "command": "node",
      "args": [
        "/path/to/docs-search/build/index.js",
        "/path/to/your-project/docs"
      ]
    }
  }
}

• commandをnodeに設定し、argsにビルド済みのサーバーファイルのパスとdocsディレクトリのパスを入力します。
• 絶対パスの使用をおすすめします。

2. Claude Desktopを再起動すると、MCPツールリストにsearch_docsが表示されます。

📚 ドキュメント

提供されるツールとリソース

ツール：search_docs

• 概要：Markdownファイルの全文検索（wakachigakiによる分かち書きをサポートする日本語検索）
• 入力パラメータ：曖昧検索と完全一致検索をサポート
• 出力形式：JSON配列で、検索結果とハイライト部分を含む

リソース：read_doc

• 説明：MCPリソースURIを通じてファイル内容を取得
• サポートされるMIMEタイプ：text/markdown

ログ記録

サーバーは主要な処理ステップで詳細なログを標準エラー出力（stderr）に出力します。

📄 ライセンス

MIT