Super Secret MCP Server
超秘密MCPサーバー
純粋な Node.js での Model Context Protocol (MCP) サーバー実装。ランダムな米国の州と署名スープの組み合わせを生成する楽しいツールを提供します。
特徴
純粋なNode.js実装
JSON-RPC 2.0準拠
MCPプロトコルバージョン: 2024-11-05
カスタムログシステム
スキーマ検証によるツールのサポート
STDIOトランスポート
Related MCP server: Vercel MCP Python Server
はじめる
前提条件
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.jsonmacOS/Linux:
$HOME/.codeium/windsurf/mcp_config.json
テスト
MCP Inspectorでサーバーを起動する
サーバーの初期化を確認する
ツールリストを確認する
テストツールの実行
応答形式を確認する
貢献
リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを作成する
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
謝辞
プロトコル仕様のモデルコンテキストプロトコルチーム
テストツールのMCP Inspectorチーム
つながり続ける
最新情報、ニュース、コミュニティのディスカッションについては、お気に入りのプラットフォームでフォローしてください。
Available Tools
1 toolgetSecretPassphraseD
Whats the password?
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The tool's purpose is singular and clearly defined, so disambiguation is perfect.
A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The naming follows a clear verb_noun pattern (getSecretPassphrase).
One tool is too few for most server purposes, as it severely limits functionality and scope. This feels thin and incomplete, even for a simple server, unless it's intentionally minimalistic.
The server's purpose is unclear from the single tool, but a 'secret passphrase' domain would typically require more operations (e.g., set, update, list, delete). With only a get operation, the surface is severely incomplete and will likely cause agent failures.
Maintenance
Related MCP Connectors
A paid remote MCP for CLI tool MCP, built to return verdicts, receipts, usage logs, and audit-ready
An MCP server that provides congressional transcripts
Hosted MCP server to manage a restaurant menu from AI agents - 39 tools over the DuckHub API.
One MCP server exposing every tool in the Gumball portfolio.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA beginner-friendly MCP-inspired JSON-RPC server built with Node.js, offering basic client-server interaction through an 'initialize' capabilities handshake and an 'echo' function.3MIT
- AlicenseNot gradedqualityDmaintenanceA serverless MCP server deployed on Vercel that provides basic utility tools including echo, time retrieval, arithmetic operations, and mock weather information. Includes an interactive client application for testing and demonstration purposes.MIT
- FlicenseNot gradedqualityDmaintenanceA modular MCP server that provides tools for looking up country and state information. Designed as a demonstration of building extensible MCP servers with custom tool modules.-
- AlicenseNot gradedqualityDmaintenanceA basic MCP server implementation using Node.js and TypeScript that bridges AI models with external tools and data sources via JSON-RPC.2ISC