mcpField
S
Sample Shop MCP server

Sample Shop MCP server

リモート
apitoagents.com開発ツール03 週間前に更新
リポジトリ公式サイト

Sample Shop MCP server について

Sample Shop MCP serverは、公式TypeScript SDKで作られたサンプルのショップ連携で、Python、C#、PHP版もあります。ページネーション付きの読み取り、冪等な注文作成、確認を要するキャンセルを示します。

主な機能

  1. 01ページネーション付き商品検索と取得
  2. 02冪等な注文作成
  3. 03確認を必須とするキャンセル
  4. 044言語での実装

活用シーン

  1. 01サンプルショップの商品一覧の確認
  2. 02重複を防いだサンプル注文の作成
  3. 03確認必須の注文キャンセル処理のテスト

MCP 対応

商品検索、商品取得、注文作成、確認付きキャンセルをMCPツールとして提供します。stdioまたはStreamable HTTPで実行できます。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://demo.apitoagents.com/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

パッケージ
npm@apitoagents/sample-shop-mcp1.0.1

ツール

4
パラメーター型必須説明
limitintegerいいえページサイズ。
querystringいいえ商品名と説明に照合する語句。
cursorstringいいえ前のページの nextCursor に含まれる不透明なトークン。決して捏造しないでください。
categoryenumいいえ結果を 1 つのカテゴリに限定します。lighting | furniture | kitchen

詳細

@apitoagents/sample-shop-mcp

公式 TypeScript SDK で作成された、小規模なサンプルショップ向けの MCP サーバーです。実際の統合に必要な 3 種類のツールを紹介します。ページネーション対応の読み取り（search_products、get_product）、冪等性のある書き込み（create_order）、そして明示的な確認がなければ実行を拒否する保護されたアクション（cancel_order）です。

同じサーバーが Python、C#、PHP でも提供されており、いずれも同じ適合シナリオに合格しています：github.com/apitoagents/mcp-examples。手順ガイド：apitoagents.com/docs/build-mcp-server-typescript。

1 つのコマンドで試す（stdio）

npx @apitoagents/sample-shop-mcp

これにより、バンドルされた Sample Shop API が 127.0.0.1:4010 で起動し、MCP ツールが stdio 経由で提供されます。これは、ローカルサーバーに対して Claude Desktop、Claude Code、MCP Inspector が期待する方式です。

Claude Code：

claude mcp add sample-shop -- npx -y @apitoagents/sample-shop-mcp

Claude Desktop（claude_desktop_config.json）：

{ "mcpServers": { "sample-shop": { "command": "npx", "args": ["-y", "@apitoagents/sample-shop-mcp"] } } }

Streamable HTTP で実行する

UPSTREAM_URL=http://127.0.0.1:4010 npx -p @apitoagents/sample-shop-mcp node node_modules/@apitoagents/sample-shop-mcp/dist/server.js

または、リポジトリをクローンして実行します：npm ci && npm run build && npm start（127.0.0.1:3001/mcp で待ち受けます）。環境変数：HOST、PORT、UPSTREAM_URL、UPSTREAM_API_KEY（デフォルトは demo-key）、ALLOWED_HOSTS（Host ヘッダーで受け入れる公開ホスト名をカンマ区切りで指定）。

公開デモ

ホストされたバージョンを https://demo.apitoagents.com/mcp で実行しています（データはメモリ内に保存され、定期的にリセットされます）。Claude または ChatGPT にリモート MCP サーバーとして追加し、デスクランプをリクエストしてください。

MIT。自社 API 向けにこのようなサーバーを設計・ホスティングする API to Agents が開発しました。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。