Plug and Ship

plugandship-mcp

适用于 Plug and Ship 的 MCP 服务。它让你的编码 Agent 无需离开聊天界面，就能搜索 Plug and Ship 的 MCP 服务、Agent 技能和编码 Agent 插件索引。

该服务为只读。它调用公开的 Plug and Ship API（/api/v1），无需 API 密钥。

已列入官方 MCP Registry，名称为 dev.plugandship/plugandship-mcp。

工具

工具	参数	返回内容
search_tools	query 或 task（关键词或自然语言任务，例如“在 Cursor 中查询我的 Postgres”）、type?（mcp / skill / plugin）、client?（claude-code / cursor / codex / grok-bot）、remote?（仅限具有公开 HTTPS 端点的 MCP 服务）、limit?（1 到 50，默认值为 10）	按相关性排序的工具（全文匹配 + 语义匹配；星标数、最近提交、有效的一键配置和许可证仅用于打破平局），每个工具都附带一行匹配原因、安装命令和页面链接。还会返回结构化输出，包括对任务的理解。client: "grok-bot" 只保留具有公开远程（HTTP）端点的 MCP 服务。
get_tool	slug	单个工具的完整详情：描述、代码仓库、星标数、标签、安装命令，以及远程端点（如有）。
trending	period（day / week / month）、type?、limit?	增长最快的工具：该时段内新增的星标数，数据来自 Plug and Ship 自己的每日星标快照。
list_best	topic?、limit?	精选的“最佳”列表。将 topic 留空即可列出主题（例如 grok-bot-connectors、voice-agents、postgres-mcp-servers）。

使用托管端点（无需安装）

远程 MCP 服务，Streamable HTTP，无状态，无需身份验证：

https://plugandship.dev/mcp

Claude Code

claude mcp add --transport http plugandship https://plugandship.dev/mcp

Cursor（~/.cursor/mcp.json 或项目中的 .cursor/mcp.json）

{
  "mcpServers": {
    "plugandship": { "url": "https://plugandship.dev/mcp" }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.plugandship]
url = "https://plugandship.dev/mcp"

在本地运行（stdio）

需要 Node.js 18 或更高版本。直接从 GitHub 运行，无需 npm 包（已提交构建后的 dist/）：

npx -y github:plugandship/plugandship-mcp

Claude Code

claude mcp add plugandship -- npx -y github:plugandship/plugandship-mcp

Cursor

{
  "mcpServers": {
    "plugandship": {
      "command": "npx",
      "args": ["-y", "github:plugandship/plugandship-mcp"]
    }
  }
}

Codex

[mcp_servers.plugandship]
command = "npx"
args = ["-y", "github:plugandship/plugandship-mcp"]

从检出目录运行

git clone https://github.com/plugandship/plugandship-mcp
cd plugandship-mcp
npm install
npm run build
node dist/index.js

自托管 Streamable HTTP

node dist/index.js --http --port 3333 --host 127.0.0.1
# endpoint: http://127.0.0.1:3333/mcp

无状态，返回 JSON，仅支持 POST。来自 localhost 以外浏览器 Origin 的请求会被拒绝。默认绑定到 127.0.0.1。对外公开前，请先将其置于 HTTPS 后面。

配置

环境变量	默认值	用途
PLUGANDSHIP_API_URL	https://plugandship.dev	API 基础 URL（针对本地站点使用 http://localhost:3000）。

公开 API 设有缓存和速率限制（每个 IP 每分钟约 60 次请求）。遇到 429 时，工具会返回简短的“请一分钟后重试”错误。

测试

npm test                                            # stdio + local HTTP, against https://plugandship.dev
PLUGANDSHIP_API_URL=http://localhost:3000 npm test  # against a local site
MCP_REMOTE_URL=https://plugandship.dev/mcp npm run test:remote  # the hosted endpoint

npm test 会构建服务，通过 stdio 和 Streamable HTTP 启动服务，使用官方 MCP SDK 客户端连接，列出工具并逐一调用，包括错误场景（未知 slug、无效输入、外部 Origin）。test:remote 会对远程端点运行相同的检查。

Registry

server.json 是 MCP Registry 条目：仅远程服务的列表项（streamable-http，https://plugandship.dev/mcp），位于 dev.plugandship 命名空间下，并通过 DNS 验证。

许可证

MIT