mcp-basic-test

🚀 超级机密 MCP 服务器

这是一个基于纯 Node.js 实现的 Model Context Protocol (MCP) 服务器，它提供了一个有趣的工具，能生成美国州和特色汤的组合。

🚀 快速开始

先决条件

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

安装

1. 克隆仓库：

git clone git@github.com:gbti-network/mcp-basic-test.git
cd mcp-basic-test

2. 安装依赖项：

npm install

运行检查器

使用 MCP 检查器启动服务器：

npx @modelcontextprotocol/inspector -- node index.js

服务器将启动并可通过 STDIO 进行连接。

✨ 主要特性

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

💻 使用示例

基础用法

getSecretPassphrase

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

• 特拉华州 - 芝士蛋糕
• 内布拉斯加 - 玉米汤
• 科罗尼尔 - 槐豆布丁
• 阿肯色州 - 鳄鱼肉汤
• 佛罗里达州 - 培根蛋挞

高级用法

其他工具（示例）

{
  "toolName": "getRandomFact",
  "description": "返回一个随机的事实。"
}

📚 详细文档

项目结构

项目文件夹/
├── index.js          # 主服务器文件
├── tools/           # 工具目录
│   ├── getSecretPassphrase.js      # 获取机密密码短语的工具
│   └── getRandomFact.js            # 获取随机事实的工具
└── package.json     # 项目依赖管理文件

开发

1. 创建功能分支
2. 实现新特性或修复问题
3. 提交代码更改
4. 推送到分支
5. 创建拉取请求

测试

1. 启动服务器并连接 MCP 检查器
2. 验证服务器初始化状态
3. 检查工具列表
4. 测试工具执行结果
5. 确认响应格式正确性

贡献指南

1. 叉取仓库
2. 创建功能分支
3. 提交代码更改
4. 推送到分支
5. 发起拉取请求

📄 许可证

本项目使用 MIT 许可证，详情请参阅 LICENSE 文件。

致谢

感谢以下团队的努力：

• Model Context Protocol 团队 - 协议规范制定者
• MCP 检查器团队 - 测试工具开发者

保持联系

关注我们的官方平台获取最新资讯和社区讨论：

• 推特/X
• GitHub
• YouTube
• Dev.to
• Daily.dev
• Hashnode
• Discord
• Reddit