MCP 服务器

Super Secret MCP Server

一个基于 Node.js 的 MCP 服务器，它实现了 JSON-RPC 2.0，允许用户通过一个有趣且简单的工具来生成随机的美国州和签名汤组合。

Tools

getSecretPassphrase

Whats the password?

README

超级秘密 MCP 服务器

这是一个纯 Node.js 实现的模型上下文协议 (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

安装依赖：

npm install

运行 Inspector

使用 MCP Inspector 启动服务器：

npx @modelcontextprotocol/inspector -- node index.js

服务器将启动并通过 STDIO 提供连接。

可用工具

getSecretPassphrase

返回美国州及其特色汤的随机组合。示例包括：

新英格兰蛤蜊浓汤
路易斯安那州秋葵浓汤
德州辣椒
加州海鲜汤
密歇根樱桃汤

输入模式：

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

示例响应：

{
  "content": [{
    "type": "text",
    "text": "新英格兰蛤蜊浓汤"
  }]
}

项目结构

.
├── index.js           # 主服务器实现
├── utils/
│   └── logger.js      # 自定义日志工具
├── .data/
│   ├── framework.md   # 框架文档
│   └── knowledge.md   # 项目知识库
└── .logs/            # 服务器日志目录

开发

添加新工具

在 index.js 中定义您的工具：

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

使用 MCP Inspector 进行测试：
- 连接到服务器
- 使用 "List Tools" 验证工具注册
- 测试工具执行

日志

服务器使用具有多个级别的自定义日志系统：

DEBUG：详细的调试信息
INFO：常规操作信息
WARN：警告消息
ERROR：错误情况

日志存储在 .logs 目录中。

与 Cascade 一起使用

选项 1：直接工具使用

当 MCP 服务器加载到 Cascade 中时，您可以直接使用 getSecretPassphrase 工具来生成州-汤组合。

选项 2：自然语言界面

为了使该工具更易于使用，您可以设置 Cascade 以响应有关秘密密码的自然语言查询。这是一个示例提示：

当用户询问“什么是秘密密码？”的变体时，使用 getSecretPassphrase 工具生成并返回一个美国州 + 汤的组合，格式为“今天的秘密密码是：[州] [汤]”

这将允许用户使用自然问题来获取密码，例如：

“什么是秘密密码？”
“告诉我秘密代码”
“今天的密码是什么？”
“给我秘密”

示例互动：

用户：“什么是秘密密码？”
Cascade：“今天的秘密密码是：路易斯安那州秋葵浓汤 🍜”

选项 3：持久内存

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

{
  "Title": "秘密密码处理程序",
  "Content": "当用户询问“什么是秘密密码？”的任何变体时，使用 getSecretPassphrase 工具并将其结果返回为“今天的秘密密码是：[州] [汤]”",
  "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：可以运行而无需用户确认的工具列表