超秘密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