Back to MCP directory
publicPublicdnsLocal runtime

mcp-basic-test

一个纯Node.js实现的MCP服务器,提供生成随机美国州名与特色汤组合的功能,支持JSON-RPC 2.0协议,包含自定义日志系统和工具验证。

article

README

🚀 超级机密 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
  1. 安装依赖项:
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 检查器团队 - 测试工具开发者

保持联系

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

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client