使用说明
饮料MCP服务器
模型上下文协议（MCP）服务器，提供对来自世界各地的33种不同饮料的饮料数据的访问。
🚀 Docker快速入门
选项1：从GitHub容器注册表中提取
# Pull the latest image
docker pull ghcr.io/bdiep6/beverage-mcp-server:latest
# Run the server
docker run -p 8080:8080 -d --name beverage-server ghcr.io/bdiep6/beverage-mcp-server:latest
选项2：从源代码构建
# Clone the repository
git clone https://github.com/bdiep6/beverage-mcp-server.git
cd beverage-mcp-server
# Build the Docker image
docker build -t beverage-mcp-server:latest .
# Run the container
docker run -p 8080:8080 -d --name beverage-server beverage-mcp-server:latest
📡 API终点
一旦运行，服务器将提供以下REST API端点：
GET /health-健康检查GET /api/beverages-获取所有饮料GET /api/beverages/{id}-通过ID获取饮料GET /api/beverages/name/{name}-按名称搜索GET /api/beverages/type/{type}-按类型搜索GET /api/beverages/ingredient/{ingredient}-按成分搜索GET /api/beverages/origin/{origin}-按来源搜索GET /api/beverages/calories/{calories}-按卡路里搜索GET /api/beverages/count-获取总计数
🔗 消耗服务器
来自C#控制台应用程序
using var httpClient = new HttpClient();
var response = await httpClient.GetAsync("http://localhost:8080/api/beverages");
var json = await response.Content.ReadAsStringAsync();
来自JavaScript/Node.js
const response = await fetch('http://localhost:8080/api/beverages');
const beverages = await response.json();
console.log(beverages);
来自Python
import requests
response = requests.get('http://localhost:8080/api/beverages')
beverages = response.json()
print(beverages)
来自cURL
# Get all beverages
curl http://localhost:8080/api/beverages
# Search for tea beverages
curl http://localhost:8080/api/beverages/type/Tea
# Get beverage by ID
curl http://localhost:8080/api/beverages/1
📊 样品数据
该服务器包含33种饮料，包括：
- 软饮料：可口可乐、百事可乐、柠檬水
- 咖啡：浓缩咖啡、黑咖啡、拿铁
- 茶：绿茶、柴茶、抹茶拿铁
- 鸡尾酒：玛格丽塔、莫吉托、皮纳·科拉达
- 还有更多！
🛠️ 发展
地方发展（MCP模式）
dotnet run
Docker开发（HTTP模式）
docker build -t beverage-mcp-server .
docker run -p 8080:8080 beverage-mcp-server
🧪 测试
启动服务器后访问以下网址：
- 健康检查：http://localhost:8080/health
- API文件：http://localhost:8080/api
- 所有饮料：http://localhost:8080/api/beverages
📦 依赖项
- .NET 9.0
- ModelContextProtocol 0.3.0-综述。4
- ASP。NET Core（用于HTTP模式）
🐳 Docker Hub
Docker Hub上也有：
docker pull YOUR_DOCKERHUB_USERNAME/beverage-mcp-server:latest
📄 许可证
MIT许可证
