Coinbound MCP服务器:您的AI实时加密数据的门户
Coinbound MCP Server是一个生产级工具,将人工智能模型和开发环境与实时加密货币市场数据连接起来。它作为CoinGecko API的可靠、缓存和速率限制的桥梁,专为高性能应用程序设计。
这解决了什么问题?
大型语言模型(LLM)和人工智能代理无法内置访问加密货币价格等实时信息。该服务器通过为任何人工智能或应用程序提供一种安全、结构化和高效的方式来查询最新的加密数据,而无需直接处理API密钥、缓存或速率限制,从而解决了这一问题。
关键用例
- 基于人工智能的财务分析AI代理可以使用此服务器获取最新的市场数据,以分析趋势、生成报告或回答用户关于加密货币价格的问题。
- Web3营销工具:营销应用程序可以集成这些数据来显示实时价格行情、投资组合跟踪器或市场情绪仪表板。
- 自动内容创建:脚本可以使用此服务器自动生成每日市场摘要文章或具有最新价格的社交媒体帖子。
- 开发与原型制作:开发人员可以快速原型化与加密相关的应用程序,而无需设置自己的数据管道。
🚀 核心功能
- 实时数据:访问当前价格、市值和24小时变化的前500种加密货币
- 智能缓存:边缘缓存响应,TTL为45秒,以获得最佳性能
- 速率限制:内置配额管理,每天有95000个请求
- 生产就绪:部署在Cloudflare Workers上,正常运行时间为99.9%
- 专业用户界面:具有搜索、分页和API测试功能的交互式食谱网站
- 没有表情符号:适用于商业环境的干净、专业的界面
🏗️ 建筑
- 后端:使用TypeScript的Cloudflare Workers
- 缓存:用于加密货币数据的Cloudflare Cache API
- 存储:Cloudflare KV用于配额管理
- 前端:带有现代CSS的普通JavaScript
- 数据源:CoinGecko API(免费层)
📊 现场演示
参观我们的现场演示: coinbound-cookbook.pages.dev
🔗 API终点
基本URL
- 生产:
https://coinbound-mcp-server.coinbound.workers.dev - 地方发展:
http://localhost:8787
端点
获取 /crypto
返回包含当前市场数据的前500种加密货币。
响应示例:
[
{
"id": "bitcoin",
"name": "Bitcoin",
"symbol": "btc",
"current_price": 43250.50,
"market_cap": 847523849284,
"price_change_percentage_24h": 2.45
}
]获取 /quota
返回当前API配额使用情况和剩余请求。
响应示例:
{
"date": "2025-08-18",
"count": 1247,
"cap": 95000,
"remaining": 93753
}获取 /health
健康检查端点。
响应示例:
{
"status": "healthy",
"timestamp": "2025-08-18T14:06:50.597Z"
}获取 /sse
MCP客户端的服务器发送事件端点。
🛠️ 地方发展
先决条件
- Node.js 18+
- npm或纱线
- Cloudflare牧马人CLI
设置MCP服务器
- 克隆存储库
git clone https://github.com/coinbound/coinbound-mcp-server.git
cd coinbound-mcp-server- 安装依赖项
cd coinbound-mcp-server
npm install- 创建KV命名空间
wrangler kv:namespace create QUOTA_KV- 更新wrangler.toml
更新中的KV命名空间ID coinbound-mcp-server/wrangler.toml:
[[kv_namespaces]]
binding = "QUOTA_KV"
id = "your-kv-namespace-id"- 启动开发服务器
npm run devMCP服务器将在 http://localhost:8787
设置食谱网站
- 导航到烹饪书目录
cd coinbound-cookbook- 启动本地服务器
python -m http.server 3000烹饪书网站将在 http://localhost:3000
🚀 部署
将MCP服务器部署到Cloudflare Workers
cd coinbound-mcp-server
npm run deploy将Cookbook部署到Cloudflare页面
cd coinbound-cookbook
wrangler pages deploy . --project-name coinbound-cookbook将Cookbook部署到Render.com
- 将您的GitHub存储库连接到Render.com
- 创建新的静态站点
- 将构建目录设置为
coinbound-cookbook - 部署
🔧 人工智能与开发者集成指南
此服务器旨在轻松集成到任何环境中。下面是最常见用例的复制粘贴示例。
1.人工智能代理(通过MCP)
支持模型上下文协议(MCP)的AI代理可以直接连接。这是让人工智能自主访问数据的最强大方式。
通用MCP配置(mcp_config.json):
{
"servers": {
"coinbound-crypto-server": {
"transport": {
"type": "sse",
"url": "https://coinbound-mcp-server.coinbound.workers.dev/sse"
},
"resources": [
{
"name": "crypto-data",
"description": "Fetches the top 500 cryptocurrencies by market cap, including price, market cap, and 24h change. Data is cached for ~45s."
}
]
}
}
}AI提示示例:
“使用coinbound-crypto-server,访问crypto-data请告诉我以太坊的当前价格和市值。然后,找出过去24小时内表现最佳的5种硬币。"
2.用于Web应用程序(JavaScript/TypeScript)
您可以直接从任何前端应用程序调用服务器的REST端点。服务器配置了CORS,以允许基于浏览器的请求。
JavaScript示例(浏览器获取):
async function getTop500Crypto() {
const apiUrl = 'https://coinbound-mcp-server.coinbound.workers.dev/crypto';
try {
const response = await fetch(apiUrl);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
console.log('Successfully fetched 500 cryptocurrencies:', data);
// Example: Find Bitcoin's data
const bitcoin = data.find(coin => coin.id === 'bitcoin');
console.log('Bitcoin Price:', bitcoin.current_price);
} catch (error) {
console.error('Failed to fetch crypto data:', error);
}
}
getTop500Crypto();3.用于后端服务(Node.js)
将数据集成到后端服务中,以便进行服务器端处理。
Node.js示例(使用 node-fetch):
import fetch from 'node-fetch';
async function getCryptoData() {
const apiUrl = 'https://coinbound-mcp-server.coinbound.workers.dev/crypto';
try {
const response = await fetch(apiUrl);
const data = await response.json();
console.log('Top 5 coins by market cap:');
console.log(data.slice(0, 5));
} catch (error) {
console.error('Error fetching data:', error);
}
}
getCryptoData();4.用于数据分析和脚本编写(Python)
使用Python脚本中的数据进行数据分析、机器学习或自动化。
Python示例(使用 requests 图书馆):
import requests
import json
def get_crypto_data():
api_url = "https://coinbound-mcp-server.coinbound.workers.dev/crypto"
try:
response = requests.get(api_url)
response.raise_for_status() # Raises an HTTPError for bad responses
data = response.json()
print("Successfully fetched data for {} coins.".format(len(data)))
# Example: Print names of the top 5 coins
for coin in data[:5]:
print(f"- {coin['name']} (${coin['current_price']})")
except requests.exceptions.RequestException as e:
print(f"Error fetching data: {e}")
if __name__ == "__main__":
get_crypto_data(){
"mcpServers": {
"coinbound-mcp": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-fetch", "https://coinbound-mcp-server.coinbound.workers.dev"],
"env": {}
}
}
}自定义MCP客户端
{
"servers": {
"coinbound-mcp-server": {
"transport": {
"type": "sse",
"url": "https://coinbound-mcp-server.coinbound.workers.dev/sse"
},
"resources": [
{
"name": "crypto-data",
"description": "Top 500 cryptocurrencies (USD), cached ~45s via CoinGecko."
}
]
}
}
}📁 项目结构
coinbound-mcp-server/
├── coinbound-mcp-server/ # MCP Server (Cloudflare Workers)
│ ├── src/
│ │ ├── index.ts # Main worker entry point
│ │ ├── quota.ts # Quota management
│ │ └── mcp/
│ │ └── crypto.ts # MCP server definition
│ ├── package.json
│ ├── tsconfig.json
│ └── wrangler.toml # Cloudflare Workers config
├── coinbound-cookbook/ # Documentation Website
│ ├── index.html # Main webpage
│ ├── css/
│ │ └── styles.css # Coinbound-branded styles
│ ├── js/
│ │ └── app.js # Interactive functionality
│ ├── wrangler.toml # Cloudflare Pages config
│ └── _headers # Security headers
├── .gitignore
└── README.md🎨 特性
搜索和分页
- 按名称或符号搜索加密货币
- 分页,每页25、50或100个项目
- 适用于所有设备尺寸的响应式设计
实时更新
- 每60秒自动刷新一次
- 视觉状态指示器
- 错误处理和重试机制
专业设计
- 硬币装订的品牌颜色(#e85d35)
- 干净、无表情的界面
- 响应式网格布局
- 交互式API测试
🔒 安全
- 为跨源请求配置CORS标头
- 限额管理限速
- 输入验证和错误处理
- 生产部署的安全标头
📊 监控
- 用于正常运行时间监控的健康检查端点
- 配额跟踪和报告
- 错误记录和调试工具
- 通过Cloudflare Analytics获得的性能指标
🤝 贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 彻底测试
- 提交拉取请求
📄 许可证
MIT许可证-有关详细信息,请参阅许可证文件。
🆘 支持
如需支持,请联系:
- 电子邮件: support@coinbound.io
- 网站: coinbound.io
- 文档: coinbound-cookbook.pages.dev
🏢 关于Coinbound
Coinbound是领先的Web3和加密货币营销机构。我们为需要可靠、可扩展解决方案的加密货币营销团队构建专业工具和基础设施。
______________________________________________________________________
内置于❤️ Coinbound团队
