github md-mcp
A. 无服务器MCP(模型上下文协议)服务器 它将任何公共或私有GitHub存储库中的Markdown文件作为AI就绪资源公开。
特性
- ✅ 列表 全部
.mdrepo中的文件 - 📄 获取 按路径或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"
}
}
}