Beverage MCP Server

饮料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许可证