AI导哈

GitHub Markdown MCP服务

一个无服务器的MCP（模型上下文协议）服务器，将任何公共或私有GitHub仓库中的Markdown文件暴露为AI就绪资源。

  • by bPol
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 bpol/github-md-mcp

使用说明

github md-mcp

A. 无服务器MCP（模型上下文协议）服务器 它将任何公共或私有GitHub存储库中的Markdown文件作为AI就绪资源公开。

特性

  • ✅ 列表 全部 .md repo中的文件
  • 📄 获取 按路径或MCP ID显示文件内容(mcp://files/...)
  • 🔎 搜索 关键字的文件名和Markdown内容
  • 🔐 可选的API-key和HMAC身份验证
  • ⚡ 作为AWS Lambda（Node 20+）或任何Node.js无服务器运行时运行

为什么

将大型语言模型代理连接到知识库通常需要自定义管道。
此Lambda充当 桥：您的GitHub仓库将成为代理可以实时查询的MCP服务器。

快速启动

1.部署

克隆并部署 index.mjs 作为AWS Lambda（Node.js 20+）或任何接受HTTP POST端点的环境。

设置这些环境变量：

变量 描述
GH_OWNER GitHub用户或组织名称
GH_REPO 存储库名称
GH_REF （可选）分行，默认为回购默认分行
GITHUB_TOKEN GitHub个人访问令牌 repo （阅读）
MCP_API_KEY （可选）请求所需的承载令牌
MCP_HMAC_SECRET （可选）签名请求的HMAC密钥
ALLOWED_ORIGINS （可选）CORS的逗号分隔列表

2.MCP客户端配置

将您的MCP客户端（例如AI代理）指向Lambda URL：

  • initialize → 握手
  • tools/list → 发现工具
  • tools/call 与：
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "get_md_file",
    "arguments": {
      "path": "mcp://files/todo-current.md"
    }
  }
}

相关 MCP