█▀▄▀█ ▄▀█ █▄▀ █▀▀ █▀▄▀█ █▀▀ █▀█
█ ▀ █ █▀█ █ █ ██▄ ▄ █ ▀ █ █▄▄ █▀▀
文档进。MCP 服务器出。
把任何 llms.txt、文档网站、OpenAPI 规范或源码仓库变成可直接运行的 MCP 服务器——就在你的编码智能体中。精确匹配版本,可离线使用,无需 API 密钥、无需账号、不收费。
适用于 Claude Code · Cursor · Codex · Windsurf · Claude Desktop · 任何 MCP 客户端
Demo
~/projects/shop
自由软件不应该需要付费的 MCP 服务器。
文档是公开的,你的智能体就可以使用它。
许多库免费提供优秀的文档——却在你的编码智能体和这些文档之间设了付费墙。make-mcp 让你在几秒钟内自己构建 MCP 服务器,来源就是权威出处:你的锁文件中的确切版本。它在你的电脑上运行,配合你已经在用的智能体。没有托管服务,没有集中成本,也无需订阅。
## 工作原理
- 01
识别
读取你的锁文件(npm、pnpm、yarn、uv、poetry、pip …)、npm/PyPI 元数据、对应版本的仓库标签以及 llms.txt。
- 02
提问
只问它自己查不到的——每轮最多四个问题,预选合理的默认值,在你的智能体中以原生选项呈现。
- 03
确认
一份摘要:来源、版本、许可证的处理方式、服务器存放位置。
- 04
生成
生成不依赖 make-mcp 的 TypeScript 或 Python 服务器。代码归你所有,可阅读、修改和提交。
- 05
测试
安装、构建、通过 stdio 启动,并在你看到之前完成一次真实的工具调用。
- 06
注册
在向你展示改动之后,将其加入 .mcp.json 或 .cursor/mcp.json。
## 两类服务器,可组合使用
按以下顺序选用最佳可用来源:
llms-full.txt → llms.txt → repo docs @ version tag → website → README → local checkout
另有 changes_since——升级前查看你当前版本之后的发布说明——以及 get_signature——从项目中已安装的包读取准确的签名。
基于 OpenAPI 3.x 或 Swagger 2.0:每个操作一个工具,并标注只读/破坏性;GET 端点作为资源;通过环境变量认证(API 密钥、Bearer、Basic、OAuth2);API 版本可通过路径、请求头或查询参数指定。
没有规范?由你的智能体模型从文字文档中提取操作——每个操作都必须引用其来源页面原文,编造的端点会被拒绝。大型 API 会合并为 list / describe / call 工具。
- stdio 与 Streamable HTTP(旧版 SSE 可通过参数启用)
- Cloud Run 模板——Dockerfile、Knative 服务、Skaffold
- ZIP 导出,方便转交
- Apache-2.0,生成的代码归你所有
## 整个项目一个服务器
如果该库是项目的多个依赖之一,make-mcp 会询问你只为它生成服务器,还是为项目的所有库生成一个——每个库都使用 lockfile 锁定的版本,各自的来源和许可证处理。构建工具会被排除。
> /make-mcp:create .
$ npx @make-mcp/cli create .
每个工具都接受可选参数 library,例如 search_docs("routing", library: "next")。
## 安装
包含斜杠命令、技能和 make-mcp MCP 服务器的插件:
> /plugin marketplace add make-mcp/make-mcp
> /plugin install make-mcp@make-mcp
> /make-mcp:create daisyui
或者直接说“给我做一个 daisyUI 的 MCP”——技能会自动接手。
.cursor/mcp.json
{ "mcpServers": { "make-mcp": {
"command": "npx",
"args": ["-y", "@make-mcp/cli", "mcp"]
} } }
可选:将 make-mcp.mdc 复制到 .cursor/rules/。
~/.codex/config.toml
[mcp_servers.make-mcp]
command = "npx"
args = ["-y", "@make-mcp/cli", "mcp"]
可选:将 AGENTS.md 追加到你项目的 AGENTS.md。
无需智能体:
$ npx @make-mcp/cli create daisyui
$ npx @make-mcp/cli create .
$ npx @make-mcp/cli generate \
--target https://api.example.com/openapi.json --lang py --yes
$ npx @make-mcp/cli test ./mcp-servers/daisyui-mcp
同样的流程在浏览器中完成,仅限本地并受令牌保护:
$ npx @make-mcp/cli ui
或者在电脑上无需 Node.js:
$ docker run --rm -p 127.0.0.1:4321:4321 \
-v "$PWD:/workspace" -e MAKE_MCP_HOST_WORKSPACE="$PWD" \
ghcr.io/make-mcp/make-mcp
## 社区目录
为常用库和 API 准备的现成配方——说明使用哪份文档或规范,但从不包含文档本身。每个条目都是一个 Claude Code 插件,首次启动时会为你的项目所用版本构建服务器。
> /plugin marketplace add make-mcp/catalog
> /plugin install daisyui@make-mcp-catalog
Next.js · React · Vue · Svelte · Nuxt · Prisma · Pydantic · daisyUI · Zod · Bun · Expo · … – 添加你的条目。
## 以尊重为原则
- 许可证自动识别,无需询问。只有在宽松许可证(MIT、Apache-2.0、BSD、ISC、CC0、CC-BY…)下才会嵌入文档;否则服务器会在安装时于你的电脑上下载文档——不会进行再分发。
- 遵守 robots.txt 和 TDM 保留声明(
tdm-reservation、/.well-known/tdmrep.json、德国著作权法第 44b 条)。
- 绝不抓取登录或付费墙之后的内容。只使用公开文档。
- 防 SSRF 的抓取。除非你明确允许,否则不访问私有网络,绝不访问云元数据端点。
- 礼貌抓取。限速、可识别的 User-Agent、按版本缓存。
欢迎贡献——CONTRIBUTING.md。