docs-to-mcp-cli

Name: docs-to-mcp-cli
Author: AzureDevOpsAPI

本地服务

github.com/AzureDevOpsAPI记忆与知识378 周前更新

代码仓库

关于 docs-to-mcp-cli

docs-to-mcp-cli 是一个命令行工具，可根据 Markdown 文档生成可运行的 MCP 服务。它面向希望让兼容 MCP 的助手通过专用工具浏览、搜索和读取文档的团队。

主要功能

01生成独立可运行的 MCP 服务
02通过 glob 模式选择 Markdown 文件
03列出文档及内容预览
04按路径获取完整文档
05模糊搜索文档

适用场景

01让 MCP 助手访问项目文档
02从选定的 Markdown 文件生成文档服务

MCP 相关

该命令行工具生成一个 MCP 服务，通过 list_docs、get_doc 和 search_docs 工具公开 Markdown 文档。兼容 MCP 的助手可连接运行中的服务来浏览、读取和搜索文档。

#docs-to-mcp-cli #cli-tool #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "docs-to-mcp-cli-azuredevopsapi": {
      "command": "npx",
      "args": [
        "-y",
        "@tiberriver256/docs-to-mcp-cli"
      ]
    }
  }
}

启动命令npx -y @tiberriver256/docs-to-mcp-cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@tiberriver256/docs-to-mcp-clistdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

docs-to-mcp-cli

一个 CLI 工具，可生成独立、可运行的 MCP（Model Context Protocol）服务，通过特定工具提供 Markdown 文档。

什么是 MCP？

Model Context Protocol (MCP) 是一项开放标准，使 AI 助手能够访问外部工具和数据源。将文档转换为 MCP 服务后，AI 助手便可以：

浏览文档
搜索特定信息
访问任意文档的完整内容
使用文档提供更准确、更贴合上下文的回答

安装

你可以全局安装此工具：

npm install -g @tiberriver256/docs-to-mcp-cli

也可以通过 npx 直接使用：

npx @tiberriver256/docs-to-mcp-cli --docs "path/to/docs/**/*.md" --packageName MyDocsServer

用法

docs-to-mcp-cli --docs <pattern> --packageName <n> [--outDir <dir>] [--toolName <name>]

选项

-d, --docs <pattern>：Markdown 文件的 Glob 模式（必需）
-p, --packageName <n>：生成的 MCP 服务名称（必需）
-o, --outDir <dir>：打包后服务的输出目录（默认值："dist"）
-t, --toolName <name>：所记录的工具／程序包／库的名称（用于工具描述）
-v, --version：输出当前版本

示例

# Generate a server from all markdown files in the docs directory
docs-to-mcp-cli --docs "docs/**/*.md" --packageName ProjectDocs

# Specify a custom tool name and output directory
docs-to-mcp-cli --docs "documentation/**/*.md" --packageName APIDocsServer --toolName "My API" --outDir build

# Run the generated server
node dist/index.js

生成的服务工具

生成的 MCP 服务向 AI 助手提供以下工具：

list_docs：列出所有可用文档，并预览其内容
get_doc：根据路径获取指定文档的完整内容
search_docs：使用模糊匹配搜索所有文档

与 AI 助手集成

MCP 服务运行后，支持 Model Context Protocol 的 AI 助手即可连接并访问你的文档。这样，AI 就能根据你的特定文档提供更准确、更贴合上下文的回答。

开发

在本地构建 CLI 工具：

# Clone the repository
git clone https://github.com/Tiberriver256/docs-to-mcp-cli.git
cd docs-to-mcp-cli

# Install dependencies
npm install

# Build the project
npm run build

# Link for local development
npm link