我的文档MCP服务器

概要

此MCP服务器会索引指定目录下所有Markdown（.md）文件的全文，并通过MCP协议提供搜索和访问功能。

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

技术栈与实现技术

• 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