my-docs-mcp-server

概要

这个MCP服务器可以将指定目录下的Markdown（.md）文件全文索引化，并通过MCP协议进行搜索和查阅。

• 提供MCP的tools作为全文搜索（search_docs）
• 提供MCP的resources作为文件全文获取（read_doc）
• 使用TypeScript编写

技术栈・实现技术

• TypeScript: 服务器本体的实现语言。
• @modelcontextprotocol/sdk: 用于MCP服务器的协议实现和通信。
• MiniSearch: 用于Markdown文件的全文搜索索引创建和搜索。是一个轻量且快速的全文搜索库。
• wakachigaki: 用于对日语文本进行分词（tokenize）的轻量库。作为MiniSearch的tokenizer使用，大幅提升日语搜索的精度。
• 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/sample.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测试服务器的tools/resources。

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": {
    "docs-search": {
      "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。

提供的工具・资源

Tool: search_docs

• 概要: 全文搜索Markdown文件（日语使用分词tokenize进行高精度搜索）
• 输入: query（搜索词, 必须）、limit（最大条数, 可选, 默认5）
• 输出: 搜索结果（文件名、路径、片段）
• 备注: 搜索查询和正文都使用wakachigaki进行分词，实现自然的日语搜索。

Resource: read_doc

• 概要: 获取文件全文
• 输入: filePath（通过MCP资源URI指定）
• 输出: 文件全文

日志

服务器会在主要处理过程中向标准错误输出（stderr）输出详细日志。

许可证

MIT