文档进。MCP 服务器出。

把任何 llms.txt、文档网站、OpenAPI 规范或源码仓库变成可直接运行的 MCP 服务器——就在你的编码智能体中。精确匹配版本,可离线使用,无需 API 密钥、无需账号、不收费。

> /plugin marketplace add make-mcp/make-mcp
★ 在 GitHub 上关注

适用于 Claude Code · Cursor · Codex · Windsurf · Claude Desktop · 任何 MCP 客户端

Demo

~/projects/shop

自由软件不应该需要付费的 MCP 服务器。
文档是公开的,你的智能体就可以使用它。

许多库免费提供优秀的文档——却在你的编码智能体和这些文档之间设了付费墙。make-mcp 让你在几秒钟内自己构建 MCP 服务器,来源就是权威出处:你的锁文件中的确切版本。它在你的电脑上运行,配合你已经在用的智能体。没有托管服务,没有集中成本,也无需订阅。

## 工作原理

  1. 01

    识别

    读取你的锁文件(npm、pnpm、yarn、uv、poetry、pip …)、npm/PyPI 元数据、对应版本的仓库标签以及 llms.txt。

  2. 02

    提问

    只问它自己查不到的——每轮最多四个问题,预选合理的默认值,在你的智能体中以原生选项呈现。

  3. 03

    确认

    一份摘要:来源、版本、许可证的处理方式、服务器存放位置。

  4. 04

    生成

    生成不依赖 make-mcp 的 TypeScript 或 Python 服务器。代码归你所有,可阅读、修改和提交。

  5. 05

    测试

    安装、构建、通过 stdio 启动,并在你看到之前完成一次真实的工具调用。

  6. 06

    注册

    在向你展示改动之后,将其加入 .mcp.json 或 .cursor/mcp.json。

## 两类服务器,可组合使用

--mode docs

知识

按以下顺序选用最佳可用来源:

llms-full.txt → llms.txt → repo docs @ version tag → website → README → local checkout

另有 changes_since——升级前查看你当前版本之后的发布说明——以及 get_signature——从项目中已安装的包读取准确的签名。

  • search_docs
  • get_page
  • list_topics
  • get_component
  • changes_since
  • get_signature
--mode api

操作

基于 OpenAPI 3.x 或 Swagger 2.0:每个操作一个工具,并标注只读/破坏性;GET 端点作为资源;通过环境变量认证(API 密钥、Bearer、Basic、OAuth2);API 版本可通过路径、请求头或查询参数指定。

没有规范?由你的智能体模型从文字文档中提取操作——每个操作都必须引用其来源页面原文,编造的端点会被拒绝。大型 API 会合并为 list / describe / call 工具。

  • list_pets
  • create_pet
  • get_pet_by_id
  • …

## 整个项目一个服务器

如果该库是项目的多个依赖之一,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”——技能会自动接手。

## 社区目录

为常用库和 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 · … – 添加你的条目。

## 以尊重为原则

欢迎贡献——CONTRIBUTING.md。