SuperAPI AI 工具集

mcp-server-shipping

智能体与模型

查看项目

更新于 10-16 02:28

技能介绍

用途:面向“整个仓库只为产出一个个人用、跨项目复用的 MCP 服务器”的场景,讲清如何从可运行的仓库走到“任何项目都能加载”,以及开发机与其他环境的差异。示例使用作者自己的 *-polite-mcp 系列仓库名,可替换为自己的名字。注意:发布 Agent Skill 是另一套机制,见 skill-authoring-taudelta。

主要能力与用法:本技能不附带脚本,只通过让你运行的命令产生影响。运行 uv tool install、claude mcp add、claude mcp list。写入方面:uv tool install 在 uv 工具目录下建立工具环境并在 PATH(默认 ~/.local/bin/)放置 shim;claude mcp add --scope user 把服务器注册写入 Claude Code 用户级配置,--scope project 写入仓库的 .mcp.json,均可用对应卸载/移除命令回滚。网络方面:uv tool install git+… 会克隆你指定的仓库。

步骤:先在写 server.py 之前(而非事后补)在 pyproject.toml 添加 [project.scripts] 入口,例如 olx-polite-mcp = "olx_polite_mcp.server:main"。开发中针对本地工作树做可编辑安装:uv tool install -e <path-to-your-checkout>;不再频繁迭代时从 GitHub 安装:uv tool install git+https://github.com/TheodoreAD/olx-polite-mcp(可用 @<tag>/@<sha> 固定版本)。注册命令与安装来源无关:claude mcp add --scope user olx-polite-mcp olx-polite-mcp。切换来源只需再次 uv tool install,无需 claude mcp remove/re-add。--scope user 与技能全局安装方式一致,使服务器在本机所有项目可用;--scope project 仅用于希望克隆者自动获得该服务器的消费方仓库。可编辑安装与 GitHub 来源安装不能混用;若要“本地编辑但像来自 GitHub”,先自行 git clone 再 uv tool install -e 该克隆。项目级与用户级服务器在 claude 启动时需一次性批准(claude mcp list 可查看待批准项)。

分发:个人非商业规模下,uv tool install 直接从 git 远端解析,GitHub 仓库即制品库,无需 PyPI 的版本号、发布与凭据流程。

限制:资料未提供具体收费、平台支持范围与效果数据;其余细节见 references/rationale.md。