Nabchan MCP Server

🚀 nabchan-mcp-server

このプロジェクトは、Nablarchの公式ドキュメントの情報に基づき、Nablarch関連情報を返すMCPサーバーです。現在は実験段階で、改善の余地が大きいです。

🚀 クイックスタート

Dockerを使うと簡単に試すことができます：

graph LR
  a[VSCode]
  b[nabchan-mcp-server<br>（Dockerコンテナ）]
  a -->|標準入出力通信| b

VSCodeに以下の設定を追加します：

{
  "mcp": {
    "inputs": [],
    "servers": {
      "nablarch-document": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--network",
          "none",
          "-e",
          "TRANSPORT=stdio",
          "ghcr.io/backpaper0/nabchan-mcp-server"
        ]
      }
    }
  }
}

GitHub Copilot Chatを代理モードに設定し、Nablarch関連の質問を行ってください。

💻 ToolHiveを通じた実行

ToolHiveを通じて実行する場合は、以下のコマンドを実行します：

thv run --name nabchan-mcp-server ghcr.io/backpaper0/nabchan-mcp-server -- --transport=stdio

🔧 アーキテクチャ

ローカルのPython環境で実行するアーキテクチャを採用しています。

DuckDBの全文検索拡張機能（Full-Text Search Extension）とLindera形態素解析ライブラリを使用してインデックスを構築します。

解説書のHTMLファイルからテキストを抽出し、形態素解析を行い、全文検索の対象フィールドとします。その他、タイトル、概要、内容などの情報もMarkdown形式で提供され、MCPサーバーが提供するAPIを通じてアクセスできます。

graph TD
   h[Nablarchの解説書<br>（HTMLファイル）]
   c(テキスト)
   d(要約)
   t(タイトル)
   m(Markdown)
   i[DuckDB]

   h -->|BeautifulSoupで抽出<br>テキスト| c
   c -->|Linderaで形態素解析| i
   c -->|LLMで要約生成| d
   d --> i
   h -->|BeautifulSoupで抽出<br>タイトル|t
   t --> i
   h -->|html2textで変換<br>Markdown形式| m
   m --> i

MCPサーバーが提供するAPIは以下の通りです：

• read_document
  • 指定されたURLのNablarch解説書をMarkdown形式に変換した内容を返します。
• search_document
  • Nablarchの解説書を検索します。返される情報は以下の通りです：
    • タイトル
    • URL
    • 要約

🛠️ nabchan-mcp-serverの開発情報

開発環境の要件

• Python 3.11
• uv
• Git
• Docker

インデックスの構築

uv run -m tools.build_index

⚠️ 重要提示

サブモジュールの内容を取得していない場合は、まずgit submodule initとgit submodule updateを実行してください。

検索テスト

uv run -m tools.search_document -q "Nablarch"

開発時のVSCode設定例

/path/to/nabchan-mcp-serverを実際のパスに置き換えてください：

{
  "mcp": {
    "inputs": [],
    "servers": {
      "nablarch-document": {
        "command": "uv",
        "args": [
          "--directory",
          "/path/to/nabchan-mcp-server",
          "run",
          "-m",
          "nabchan_mcp_server.main"
        ]
      }
    }
  }
}

SSEトランスポートを使用する場合は、以下のように設定します：

{
  "mcp": {
    "inputs": [],
    "servers": {
      "nablarch-document": {
        "type": "sse",
        "url": "http://localhost:8000/sse"
      }
    }
  }
}

SSEを使用する場合は、以下のコマンドを実行してサーバーを起動してください：

uv run -m nabchan_mcp_server.main --transport sse --host localhost