超秘密MCPサーバー
純粋な Node.js での Model Context Protocol (MCP) サーバー実装。ランダムな米国の州と署名スープの組み合わせを生成する楽しいツールを提供します。
特徴
- 純粋なNode.js実装
- JSON-RPC 2.0準拠
- MCPプロトコルバージョン: 2024-11-05
- カスタムログシステム
- スキーマ検証によるツールのサポート
- STDIOトランスポート
はじめる
前提条件
- Node.js (最新の LTS バージョンを推奨)
- テスト用のMCP Inspector
インストール
- リポジトリをクローンします。
git clone git@github.com:gbti-network/mcp-basic-test.git
cd mcp-basic-test
- 依存関係をインストールします:
インスペクターの実行
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チーム
つながり続ける
最新情報、ニュース、コミュニティのディスカッションについては、お気に入りのプラットフォームでフォローしてください。