humcp
一个将Python函数快速暴露为MCP和REST API的服务器框架。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：humcp。 它的用途是：一个将Python函数快速暴露为MCP和REST API的服务器框架。 完整的 Skill 内容见：https://321skill.com/skills/humcp/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请调用‘search_files’工具，帮我找一下项目里所有的.log文件。”，AI会通过MCP协议调用你部署的HuMCP服务器上的对应工具，执行文件搜索并返回结果。或者，你也可以直接在浏览器访问 http://localhost:8080/docs，像使用普通API一样测试和调用这些工具。
介绍
HuMCP是一个轻量级服务器框架，它解决了开发者为AI助手（如Claude）快速创建和部署工具（Skill）的难题。开发者只需用简单的@tool装饰器标记Python函数，HuMCP便会自动将其注册为可通过MCP协议访问的工具，并同时生成对应的REST API端点及完整的Swagger文档。
使用方式极其简单：安装依赖后，将工具函数文件放入指定目录，启动服务器即可。工具会被自动发现，并立即在/docs页面提供API文档，在/mcp端点提供MCP服务。整个过程无需手动编写路由或文档。
它非常适合希望快速为团队或项目构建内部AI工具的后端开发者、全栈开发者以及智能体开发者。无论是将现有脚本AI化，还是从零开始为Claude等助手创建专用工具链，HuMCP都能大幅降低集成门槛。
建议开发者遵循项目提供的文档规范，为每个工具编写清晰的docstring和类型提示，这能确保生成的API文档和AI助手提示都准确易懂。注意，它主要是一个工具托管框架，本身不提供现成的业务工具，需要开发者自行编写具体功能。
核心特点
与需要分别开发MCP服务和REST API的方案不同，HuMCP实现了“一次编写，双协议暴露”，用同一套Python代码同时服务AI助手和传统API调用者，并自动生成交互文档，极大提升了工具的开发与集成效率。
注意事项
不适合需要复杂业务逻辑编排或高性能、高并发场景的直接使用，它更侧重于工具的快速暴露和集成。
常见问题
HuMCP和普通的FastAPI项目有什么区别？
HuMCP内置了对MCP协议的支持，能自动将工具暴露给Claude等AI助手，而普通FastAPI需要自行实现与AI的交互协议。
是否需要深入了解MCP协议才能使用？
不需要。开发者只需关注Python函数本身，HuMCP自动处理MCP协议的封装和通信。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/humcp/raw/index.md 读取 humcp 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/humcp/raw/index.md（查看排版版本）