超级秘密 MCP 服务器

纯 Node.js 中的模型上下文协议 (MCP) 服务器实现，提供了一个有趣的工具来生成随机的美国州和签名汤组合。

特征

纯 Node.js 实现
符合 JSON-RPC 2.0 标准
MCP协议版本：2024-11-05
自定义日志系统
具有模式验证的工具支持
STDIO传输

入门

先决条件

Node.js（推荐使用最新 LTS 版本）
MCP 检查器用于测试

安装

克隆存储库：

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：详细的调试信息
信息：一般操作信息
WARN：警告信息
错误：错误条件

日志存储在.logs目录中。

与 Cascade 一起使用

选项 1：直接使用工具

当 MCP 服务器在 Cascade 中加载时，您可以直接使用getSecretPassphrase工具生成 state-soup 组合。

选项 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：持久内存

对于更永久的设置，您可以创建一个跨会话持续存在的 Cascade 内存：

{
  "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

Integrations