超级秘密 MCP 服务器
纯 Node.js 中的模型上下文协议 (MCP) 服务器实现，提供了一个有趣的工具来生成随机的美国州和签名汤组合。
特征
纯 Node.js 实现
符合 JSON-RPC 2.0 标准
MCP协议版本：2024-11-05
自定义日志系统
具有模式验证的工具支持
STDIO传输
Related MCP server: Puzzlebox
入门
先决条件
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.jsonmacOS/Linux：
$HOME/.codeium/windsurf/mcp_config.json
测试
使用 MCP Inspector 启动服务器
验证服务器初始化
检查工具列表
测试工具执行
验证响应格式
贡献
分叉存储库
创建你的功能分支
提交你的更改
推送到分支
创建拉取请求
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。
致谢
模型上下文协议团队负责协议规范
MCP Inspector 测试工具团队
保持联系
在您最喜欢的平台上关注我们，了解最新动态、新闻和社区讨论：