Nabchan MCP Server

🚀 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

API文檔

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