AI导哈

MCP协议开发工具包

一个用于生成OpenAPI规范、客户端SDK和MCP应用的开发工具包，支持工具发现和测试。

  • by ambergristle
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ambergristle/hono-mcp-generator

使用说明

入门指南

要安装依赖项，请执行以下操作：

bun install

要生成OpenAPI规范，以及客户端SDK和MCP应用程序：

bun client:gen

然后取消评论 mcpApp 导入和路由 src/index.ts:

import mcpApp from '../sdk/mcp.gen';
// ...
app.route('/mcp', mcpApp);

要运行：

bun dev

打开http://localhost:3000

要启动MCP检查器：

bun mcp:inspector

测试

  1. 将MCP检查器目标URL设置为 http://localhost:3000/mcp.

  2. 选择 Connect那么 List Tools.

  3. 选择 Get User 工具。

  4. 添加任意ID值作为路径参数。

  5. 选择 Run Tool.

  6. 返回的模拟用户应具有您输入的ID值！

备注

  • 任何TypeScript错误都会导致客户端生成失败，因此必须将初始生成的MCP导入注释掉。
  • 这 @modelcontextprotocol/sdk 依赖关系仅与Zod 3兼容，因此 openapi-ts 配置已相应更新。
  • 路径在 openapi-ts 配置已更新为与此项目的结构兼容。
  • 这 api-config.ts 该文件依赖于生成的类型文件，这似乎有点脆弱，但不会导致任何编译时问题。
  • 这 api-config.ts 文件已修改为直接包含 clientConfig，以及项目特定值，如 appConfig 和 ApiError 为了简单起见，被删除了。

路线图

  • 这 registerTool 建议采用以下方法 tool 以获得更强大的用例。
  • 添加一个可能会有所帮助 List Tools MCP端点，帮助客户发现可用的工具和资源。
  • 目前不支持通过MCP传递身份验证凭据。

相关 MCP