AI导哈

MCP协议服务器工具

一个基于MCP（Model Context Protocol）协议的服务器实现，提供设备列表获取和新增设备等工具功能，适用于开发测试环境。

  • by hudakaspex
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 hudakaspex/mcp-server-playground

使用说明

mcp游乐场

简短描述 此存储库包含打包为npm包的MCP（模型上下文协议）服务器实现 @m.huda/mcp-playground.服务器通过MCP服务器API公开一小组工具，并在启动时通过stdio运行。

关键文件

  • src/mcp-server.ts --MCP服务器定义和注册工具。
  • src/index.ts --将服务器连接到stdio传输的入口点。
  • build/index.js --已发布包和本地运行项使用的编译输出。
  • package.json --项目元数据、脚本和包 bin 宣言。

这个项目实现了什么

  • 服务器注册的工具（示例）：
    • GET_DEVICE_LIST -从公共API获取设备列表。
    • ADD_NEW_DEVICE --接受设备有效载荷（通过验证 zod)并将其发布到公共API。

这些在 src/mcp-server.ts 并通过在那里创建的MCP服务器实例公开。

如何在本地运行（开发）

  1. 安装依赖项：
npm install
  1. 快速重载运行（开发）：
npm run dev
  1. 构建并运行编译后的输出：
npm run build
npm run start
# or
node build/index.js

如何运行已发布/“云”服务器

此软件包发布为 @m.huda/mcp-playground已发布的包公开了 bin 它运行编译的 build/index.js。您可以通过以下方式运行云/发布服务器 npx:

npx @m.huda/mcp-playground

要发布新版本（示例流程）：

npm run build
npm run publish-minor

MCP服务器配置（由工具使用）

此处包含此JSON代码段，以便工具或其他项目可以轻松引用开发和测试期间使用的云和本地服务器条目。

{
  "mcpServers": {
    "mcp-playground": {
      "command": "npx",
      "args": [
        "@m.huda/mcp-playground"
      ]
    },
    "mcp-playground-local": {
      "command": "node",
      "args": [
        "D:\\GITHUB\\mcp-playground\\build\\index.js"
      ]
    }
  },
  "preferences": {
    "menuBarEnabled": true
  }
}

备注

  • 云入口(mcp-playground)通过以下方式运行已发布的npm包 npx 并且对于快速测试已发布的服务器而无需在本地构建非常有用。
  • 本地入口(mcp-playground-local)运行已编译的 build/index.js 直接从您的工作树中，便于调试本地更改。

相关 MCP