Cat Facts MCP服务器演示
这是AI为Cat Facts API生成的MCP服务器https://catfact.ninja/
需要在API规范的基础上为MCP服务器编写理解功能和可选逻辑的思想,以便LLM模型理解并利用MCP服务器
特性
三个主要工具:
- get_random_fact-获取一个随机的猫事实
- 可选的 max_length 限制事实长度的参数
- get_facts-获取猫事实的分页列表
- limit 参数(每页1-100个事实) - max_length 按事实长度过滤的参数 - page 分页参数
- get_breeds-获取猫品种的分页列表
- limit 参数(每页1-100个品种) - page 分页参数
关键实施细节
- 类型安全:所有API响应的完整TypeScript接口
- 错误处理:针对网络故障和API错误的全面错误处理
- 参数验证:所有参数的输入模式验证
- 干净的响应格式:结构化JSON响应,分页信息与数据分离
- MCP合规性:遵循MCP服务器标准,提供适当的工具注册和处理程序
用法
要使用此服务器,请执行以下操作:
- 安装依赖项:
npm install - 编译:
npm run build - 运行:
npm start - 测试:
npx @modelcontextprotocol/inspector node dist/catfacts-server.js
服务器通过以下方式连接 stdio 并通过MCP协议提供对Cat Facts API的访问,从而可以轻松地将Cat Facts和品种信息集成到任何MCP兼容的应用程序中。
