For Five Coffee MCP Server

  ](https://nodejs.org/)

五咖啡MCP服务器

一种模型上下文协议（MCP）服务器，提供对以下内容的访问 五杯咖啡 菜单数据。与Claude Desktop、Cursor和其他MCP客户端配合使用，并提供REST API。

快速开始

git clone https://github.com/Kong/for-five-mcp.git
cd for-five-mcp
npm install
npm start

这从两个方面开始：

• MCP服务器 （stdio）-用于AI助手
• HTTP API （端口3000）-用于web应用程序

MCP客户端设置

克劳德桌面版

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "for-five-coffee": {
      "command": "node",
      "args": ["/path/to/for-five-mcp/server.js"]
    }
  }
}

光标

选项1：让Cursor启动服务器 添加到 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "for-five-coffee": {
      "command": "node",
      "args": ["/path/to/for-five-mcp/server.js"],
      "env": {
        "PORT": "3000"
      }
    }
  }
}

选项2：连接到已运行的服务器 如果你在跑步 npm start 另外，将此添加到 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "for-five-coffee": {
      "url": "http://localhost:3000/mcp",
      "transport": "http"
    }
  }
}

这将通过HTTP JSON-RPC 2.0传输将Cursor连接到正在运行的MCP服务器。

使用示例

询问你的AI助手

• “For Five coffee有什么咖啡饮料？”
• “在菜单上搜索糕点”
• “最便宜的咖啡是什么？”
• “给我看看所有的茶品种”

使用HTTP API

# Get full menu
curl http://localhost:3000/api/menu

# Search for items
curl "http://localhost:3000/api/menu/search?q=latte"

# Get categories
curl http://localhost:3000/api/menu/categories

在您的代码中

// Fetch menu data
const response = await fetch('http://localhost:3000/api/menu');
const menu = await response.json();

// Search items
const search = await fetch('http://localhost:3000/api/menu/search?q=coffee');
const results = await search.json();

import requests

# Get menu
menu = requests.get('http://localhost:3000/api/menu').json()

# Search
results = requests.get('http://localhost:3000/api/menu/search', 
                      params={'q': 'latte'}).json()

可用端点

MCP工具

• get_full_menu -获取完整菜单
• search_menu_items -按查询搜索
• get_menu_categories -列出类别
• get_items_by_category -按类别筛选

发展

npm run dev          # Start with auto-restart
npm test             # Run all tests
npm run test:unit    # Unit tests only
npm run test:http    # HTTP API tests only  
npm run test:mcp     # MCP transport tests only
npm run test:integration # Integration tests only
npm run lint         # Check code style

故障排除

MCP不工作？

• 检查到的绝对路径 server.js 在您的配置中
• 配置更改后重新启动MCP客户端
• 跑 npm start 手动测试

HTTP API没有响应？

• 确保服务器正在运行： npm start
• 检查端口3000是否未使用： lsof -i :3000
• 测试： curl http://localhost:3000/health

没有菜单数据？

• 检查互联网连接
• 服务器自动处理SSL问题
• 网站结构可能已经改变（包括回退）

许可证

Apache 2.0