云成本计算器MCP
一个完整的模型上下文协议（MCP）实现，通过多个客户端接口展示云成本比较功能。该项目完全使用TypeScript/Node.js构建，展示了MCP在创建具有现实实用性的人工智能辅助工具方面的能力。
🌟 概述
该项目为AWS成本比较提供了一个完整的MCP生态系统：
- MCP服务器 -npm可安装的MCP服务器，将AWS EC2定价与其他云提供商进行比较
- CLI客户端 -基于终端的对话界面，具有本地/远程MCP模式
- web客户端 -通用的基于web的MCP测试仪，可与任何GitHub托管的MCP服务器配合使用
关键创新： web客户端是一个通用的MCP测试工具，虽然它默认为我们的云成本计算器，但您可以将其指向任何GitHub托管的MCP服务器，通过现代web UI进行测试和交互。
Universal MCP Web Client *通用MCP Web客户端-通过现代实时聊天界面连接到任何GitHub托管的MCP服务器*
✨ 特性
MCP服务器
- 💰 成本比较：将AWS EC2实例成本与其他云定价进行比较
- 📊 详细分解：每个实例的成本分析，包括节省百分比
- 🌍 多区域支持：美国东部-1、美国西部-2、欧洲西部-1
- 📦 npm可安装：发布到GitHub并通过npm安装
- 🔧 两个MCP工具:
- calculate_instance_savings -比较成本并获得建议 - list_supported_instances -发现可用的实例类型
CLI客户端
- 💬 会话界面：Claude提供的自然语言交互
- 🔌 双模式操作:
- 本地模式：在开发过程中使用本地MCP服务器 - 远程模式：从GitHub自动安装MCP服务器
- 🎯 引导提示：结构化信息收集
- ⚡ 快速迭代：非常适合测试MCP服务器更改
Web客户端（通用MCP测试仪）
- 🌐 通用：连接到任何GitHub托管的MCP服务器
- 🎨 现代用户界面：React+顺风CSS界面
- 🔍 工具发现：自动显示可用的MCP工具
- 💬 实时聊天：与Claude进行基于WebSocket的对话
- 🐳 容器化：使用Docker compose进行完整的Docker设置
- 🔧 预配置：默认使用云成本计算器进行即时演示
- 📱 响应式：适用于台式机、平板电脑和移动设备
🏗️ 建筑
┌─────────────────────────────────────────────────────────────┐
│ Client Layer │
│ ┌──────────────────┐ ┌──────────────────┐ │
│ │ CLI Client │ │ Web Client │ │
│ │ (Terminal) │ │ (Browser UI) │ │
│ │ │ │ │ │
│ │ • Local mode │ │ • Config panel │ │
│ │ • Remote mode │ │ • Chat UI │ │
│ │ • Claude chat │ │ • Tool explorer │ │
│ └────────┬─────────┘ └────────┬─────────┘ │
└───────────┼──────────────────────────────────┼──────────────┘
│ │
│ MCP Protocol │
│ (stdio/JSON-RPC) │
│ │
┌───────────┴──────────────────────────────────┴──────────────┐
│ MCP Server Layer │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Cloud Cost Calculator MCP Server │ │
│ │ (TypeScript/Node.js) │ │
│ │ │ │
│ │ Tools: │ │
│ │ • calculate_instance_savings │ │
│ │ • list_supported_instances │ │
│ │ │ │
│ │ Data: Static pricing.json │ │
│ └──────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘📦 项目结构
cloud-cost-calculator-mcp/
├── mcp-server/ # TypeScript MCP Server
│ ├── src/
│ │ ├── index.ts # MCP server implementation
│ │ ├── calculator.ts # Cost calculation engine
│ │ ├── data-loader.ts # Pricing data loader
│ │ └── data/
│ │ └── pricing.json # AWS & alternative pricing
│ ├── package.json # npm package config
│ └── README.md
│
├── cli-client/ # CLI Client
│ ├── src/
│ │ ├── index.ts # CLI entry point
│ │ ├── mcp-lifecycle.ts # MCP server lifecycle
│ │ ├── claude-client.ts # Claude integration
│ │ └── types.ts # TypeScript types
│ ├── package.json
│ └── README.md
│
├── web-client/ # Universal Web Client
│ ├── backend/ # Express API + WebSocket
│ │ ├── src/
│ │ │ ├── services/ # GitHub installer, MCP manager
│ │ │ ├── routes/ # REST API routes
│ │ │ ├── websocket/ # Chat handler
│ │ │ └── server.ts # Main server
│ │ └── Dockerfile
│ │
│ ├── frontend/ # React UI
│ │ │ ├── components/ # React components
│ │ │ ├── hooks/ # Custom hooks
│ │ │ ├── services/ # API client
│ │ │ └── App.tsx # Main app
│ │ └── Dockerfile
│ │
│ ├── docker-compose.yml
│ └── README.md
│
└── docs/ # Documentation
├── PRD.md # Product requirements
├── PRD-WEB-CLIENT.md # Web client PRD
└── IMPLEMENTATION_PHASES.md🚀 快速开始
先决条件
- Node.js 18+
- 无烟煤API密钥 (在这里买一个)
- Docker&Docker编写 （适用于web客户端）
选项1:Web客户端（推荐）🌐
开始和测试任何GitHub MCP服务器的最快方法：
# Navigate to web client
cd web-client
# Configure
cp .env.example .env
# Edit .env and add your ANTHROPIC_API_KEY
# Start with Docker
docker-compose up --build
# Open browser
open http://localhost:3000您将获得：
- 预配置以连接到云成本计算器MCP
- 具有实时聊天功能的现代网络界面
- 工具发现和探索
- 可以切换到任何GitHub MCP服务器
选项2:CLI客户端🖥️
对于终端爱好者和快速发展：
# Build MCP server (if testing locally)
cd mcp-server
npm install && npm run build
cd ..
# Set up CLI client
cd cli-client
npm install && npm run build
# Configure
echo "ANTHROPIC_API_KEY=your_key_here" > .env
# Run in local mode (uses ../mcp-server)
npm start
# OR run in remote mode (installs from GitHub)
npm start -- --remote选项3：独立使用MCP服务器📦
直接安装和使用MCP服务器：
# Install from GitHub
npm install github:scorzo/cloud-cost-calculator-mcp#main
# Use in Claude Desktop
# Edit: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"cloud-cost": {
"command": "npx",
"args": ["-y", "@scorzo/cloud-cost-calculator-mcp"]
}
}
}💬 使用示例
CLI客户端
$ npm start
🌥️ Cloud Cost Comparison Assistant
You: I'm running 3 t3.micro instances in us-east-1, all 24/7
[Calling tool: calculate_instance_savings]```