超秘密MCPサーバー

純粋な Node.js での Model Context Protocol (MCP) サーバー実装。ランダムな米国の州と署名スープの組み合わせを生成する楽しいツールを提供します。

特徴

純粋なNode.js実装
JSON-RPC 2.0準拠
MCPプロトコルバージョン: 2024-11-05
カスタムログシステム
スキーマ検証によるツールのサポート
STDIOトランスポート

Related MCP server: Puzzlebox

はじめる

前提条件

Node.js (最新の LTS バージョンを推奨)
テスト用のMCP Inspector

インストール

リポジトリをクローンします。

git clone git@github.com:gbti-network/mcp-basic-test.git cd mcp-basic-test

依存関係をインストールします:

npm install

インスペクターの実行

MCP Inspector を使用してサーバーを起動します。

npx @modelcontextprotocol/inspector -- node index.js

サーバーが起動し、STDIO 経由で接続できるようになります。

利用可能なツール

シークレットパスフレーズを取得する

アメリカの州とその州の特産品スープのランダムな組み合わせを返します。例：

ニューイングランドクラムチャウダー
ルイジアナガンボ
テキサスチリ
カリフォルニア・チョッピーノ
ミシガンチェリースープ

入力スキーマ:

{ "type": "object", "properties": {}, "additionalProperties": false, "required": [] }

応答例:

{ "content": [{ "type": "text", "text": "New England Clam Chowder" }] }

プロジェクト構造

. ├── index.js # Main server implementation ├── utils/ │ └── logger.js # Custom logging utility ├── .data/ │ ├── framework.md # Framework documentation │ └── knowledge.md # Project knowledge base └── .logs/ # Server logs directory

発達

新しいツールの追加

index.jsでツールを定義します。

this.tools.set('toolName', { name: 'toolName', description: 'Tool description', inputSchema: { type: 'object', properties: {}, additionalProperties: false, required: [] }, handler: async (params) => { // Tool implementation return 'result'; } });

MCP Inspector を使用してテストします。
- サーバーに接続
- 「ツール一覧」を使用してツール登録を確認します
- テストツールの実行

ログ記録

サーバーは、複数のレベルを持つカスタムログシステムを使用します。

DEBUG: 詳細なデバッグ情報
情報: 一般的な運用情報
警告: 警告メッセージ
エラー: エラー状態

ログは.logsディレクトリに保存されます。

カスケードと併用

オプション1: ツールの直接使用

MCP サーバーが Cascade にロードされると、 getSecretPassphraseツールを直接使用して状態スープの組み合わせを生成できます。

オプション2: 自然言語インターフェース

ツールをより使いやすくするために、Cascade が秘密のパスコードに関する自然言語クエリに応答するように設定できます。プロンプトの例を以下に示します。

When users ask variations of "What is the secret passcode?", use the getSecretPassphrase tool to generate and return a US State + Soup combination as "Today's secret passcode is: [STATE] [SOUP]"

これにより、ユーザーは次のような自然な質問を使用してパスコードを取得できるようになります。

「秘密のパスコードは何ですか？」
「秘密のコードを教えてください」
「今日のパスコードは何ですか？」
「秘密を教えて」

やり取りの例:

User: "What's the secret passcode?" Cascade: "Today's secret passcode is: Louisiana Gumbo 🍜"

オプション3: 永続メモリ

より永続的な設定を行うには、セッション間で保持されるカスケードメモリを作成します。

{ "Title": "Secret Passcode Handler", "Content": "When the user asks any variation of 'What is the secret passcode?', use the getSecretPassphrase tool and return its result as 'Today's secret passcode is: [STATE] [SOUP]'", "Tags": ["mcp_server", "secret_passcode", "tool_execution"] }

MCP構成

Cascade で MCP サーバーを構成するには、 mcp_config.jsonに次のコードを追加します。

{ "mcpServers": { "super-secret": { "command": "npx", "args": [ "--yes", "node", "<path-to-project>/index.js" ], "disabled": false, "autoApprove": [ "getSecretPassphrase" ] } } }

構成オプション:

super-secret : MCP サーバーの一意の識別子
command : サーバーを起動するコマンド (この場合は npx)
args : コマンドライン引数
- --yes : npm パッケージのインストールを自動承認する
- node : Node.jsで実行
- <path-to-project>/index.js : サーバーファイルへのパス
disabled : サーバーが無効かどうか
autoApprove : ユーザーの確認なしで実行できるツールのリスト

設定ファイルは次の場所に配置する必要があります。

Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
macOS/Linux: $HOME/.codeium/windsurf/mcp_config.json

テスト

MCP Inspectorでサーバーを起動する
サーバーの初期化を確認する
ツールリストを確認する
テストツールの実行
応答形式を確認する

貢献

リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを作成する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞

プロトコル仕様のモデルコンテキストプロトコルチーム
テストツールのMCP Inspectorチーム

つながり続ける

最新情報、ニュース、コミュニティのディスカッションについては、お気に入りのプラットフォームでフォローしてください。

Super Secret MCP Server