Plug and Ship

plugandship-mcp

Plug and Ship 用の MCP サーバーです。チャットから離れることなく、コーディングエージェントで Plug and Ship の MCP サーバー、エージェントスキル、コーディングエージェントプラグインのインデックスを検索できます。

読み取り専用です。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）	関連度順に並べられたツール（全文検索と意味検索による一致。スター数、最近のコミット、有効なワンクリック設定、ライセンスは同点の場合のみ考慮されます）。それぞれに、一致する理由を示す1行の説明、インストールコマンド、ページへのリンクが含まれます。タスクから理解した内容を含む、構造化された出力も返します。client: "grok-bot" を指定すると、公開リモート（HTTP）エンドポイントを持つ MCP サーバーのみが対象になります。
get_tool	slug	ツール1件の詳細情報：説明、リポジトリ、スター数、タグ、インストールコマンド、およびリモートエンドポイントがある場合はその情報。
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 が返された場合、ツールは「1分後にもう一度お試しください」という短いエラーを返します。

テスト

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 のエントリーです。DNS 認証済みの dev.plugandship 名前空間における、リモート専用の登録（streamable-http、https://plugandship.dev/mcp）です。

ライセンス

MIT