猫事实API服务

Cat Facts MCP服务器演示

这是AI为Cat Facts API生成的MCP服务器https://catfact.ninja/

需要在API规范的基础上为MCP服务器编写理解功能和可选逻辑的思想，以便LLM模型理解并利用MCP服务器

特性

三个主要工具：

1. get_random_fact-获取一个随机的猫事实

   • 可选的 max_length 限制事实长度的参数

2. get_facts-获取猫事实的分页列表

   • limit 参数（每页1-100个事实）
   • max_length 按事实长度过滤的参数
   • page 分页参数

3. 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兼容的应用程序中。