mcpField
M
MCP Server Playground

MCP Server Playground

ローカル
github.com/psaboia開発ツール785 週間前に更新
リポジトリ

MCP Server Playground について

MCP Server Playgroundは、MCPサーバー開発者向けのTypeScript製学習・実験プロジェクトです。モジュール式のサンドボックスで、Claude DesktopやCursor IDE向けの連携テストやツール拡張を行えます。

主な機能

  1. 01TypeScriptによるサーバー実装
  2. 02拡張しやすいモジュール構成
  3. 03実験用サンドボックス
  4. 04Claude DesktopとCursor IDE向け

活用シーン

  1. 01TypeScript製MCPサーバーの学習
  2. 02Claude Desktopとの連携テスト
  3. 03Cursor IDEでのサーバー拡張の実験

MCP 対応

実験や拡張に使えるMCPサーバーのサンプルで、Claude DesktopとCursor IDE向けに設定できます。READMEには具体的なツールの記載はありません。

#mcp#cursor-ide#claude-desktop#aiworkflow#mcp-server#typescript#development

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "playground": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
起動コマンドnpx -y @smithery/cli

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@smithery/cli

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

MCP Server Playground

smithery badge

Server Playground MCP server

このリポジトリは、TypeScript で構築された MCP Server を試すためのプレイグラウンドです。MCP Server の構築に関するチュートリアルと動画を独自にアレンジしたもので、学習リソースであると同時に、Calude Desktop や Cursor IDE との連携をテストするためのプラットフォームとしても利用できます。

背景

このプロジェクトは、以下の資料を基にしています。

元のチュートリアルを基盤として、内容を拡張しました。チュートリアルの例に加え、MCP Server の実験に使える堅牢なプレイグラウンドへと発展させるため、追加のツールや機能を導入する予定です。

特長

  • TypeScript ベースのサーバー： 構造を改善し、エラーを検出しやすくするために TypeScript を活用しています。
  • モジュール設計： 新しいコマンド、機能、連携を簡単に拡張できます。
  • 連携に対応： 開発体験を向上させるため、Calude Desktop と Cursor IDE で動作するように設計されています。
  • 拡張可能なプレイグラウンド： チュートリアルの例にとどまらず、追加のツールや変更を試せるサンドボックス環境です。

はじめに

前提条件
  • Node.js（v12 以降）
  • npm（または任意で Yarn）
  • TypeScript（グローバルにインストールされていない場合）
Smithery 経由でのインストール

Smithery 経由で Claude Desktop に MCP Server Playground を自動インストールするには：

npx -y @smithery/cli install mcp-server-playground --client claude
インストール
  1. リポジトリをクローンします： 
    git clone <repo_url>
cd mcp-server-playground
  2. 依存関係をインストールします： 
    npm install
  3. プロジェクトをビルドします： 
    npm run build
設定

このプロジェクトでは環境変数を使用します。設定オプションを指定するには、.env ファイルを作成してください。今後、サンプルファイル（.env.example）が提供された場合は、テンプレートとして使用してください。

開発

  • IDE との連携：
    • Cursor IDE と Calude Desktop でスムーズに動作するように設計されています。
    • これらの IDE がサポートする組み込みツールや拡張機能を活用して、生産性を最大限に高めてください。
  • プロジェクトの拡張：
    • 新しいコマンドや連携を追加したり、既存の機能を変更したりできます。
    • サーバーのモジュール構造により、追加のツールや機能を簡単に組み込めます。

プロジェクト構成

mcp-server-playground/
├── src/                # Source code directory
│   └── index.ts       # Main server implementation
├── build/             # Compiled JavaScript files
├── package.json       # Project dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── README.md         # Project documentation

利用可能なスクリプト

  • npm run build - TypeScript コードをコンパイルし、適切な権限を設定します
  • npm run prepare - ビルドスクリプトを実行します（Git フックに便利です）
  • npm run watch - TypeScript ファイルの変更を監視します
  • npm run inspector - MCP inspector ツールを実行します

貢献

貢献を歓迎します！提案や改善案、新しい連携がある場合は、リポジトリをフォークし、変更を加えてプルリクエストを作成してください。

参考資料

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。

注記

このプロジェクトは、MCP Server 向けのさまざまな応用や連携をテストするためのサンドボックス環境です。新しいツールやアイデアの開発に合わせて、更新や拡張を行います。

ロードマップ

  • チュートリアルの例以外にも、ツールとの統合を実装する
  • 各ツールの包括的なドキュメントを追加する
  • Calude Desktop との統合例を作成する
  • Cursor IDE との統合用にカスタムツールを開発する
  • テストフレームワークとその使用例を追加する

コメント

Markdown 対応

MCP は初めてですか？

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

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