Frankencoin MCP服务器
通过三个接口实时传输Frankencoin（ZCHF）协议数据——选择适合您堆栈的数据：
| 接口 | 端点 | 最适合 |
|---|---|---|
| 主控程序 | POST https://mcp.frankencoin.com/mcp | Claude Desktop、Cursor、任何兼容MCP的代理 |
| REST API | GET https://mcp.frankencoin.com/api/ | 代理、脚本、curl——单个请求，无握手 |
| 命令行界面 | frankencoin | 航站楼的人 |
公共端点： https://mcp.frankencoin.com
______________________________________________________________________
工具（v2.0-13整合工具）
主办单位： 代理人需要什么而不是数据来自哪里。每个责任人一个工具。
| # | 工具 | 说明 |
|---|---|---|
| 1 | get_protocol_snapshot | 全实时状态——供应（每条链）、TVL、FPS价格/储备/收益、储蓄率、挑战 |
| 2 | get_market_data | 价格、挂钩健康、瑞士法郎稳定币比较（ZCHF/VCHF/CHFAU）、宏观（BTC/ETH）、抵押品价格 |
| 3 | get_savings | 利率（已批准+待处理）+模块统计数据（TVL、已付利息、存款、取款） |
| 4 | get_governance | 利率建议、造币厂申请、FPS股票交易、持有人统计数据。 type 要筛选的参数 |
| 5 | get_positions | 造币场。 detail=true 获取完整的链上数据；默认返回地址列表 |
| 6 | get_challenges | 抵押品细节、定价、头寸背景的清算挑战 |
| 7 | get_collaterals | 所有链中接受的抵押品类型 |
| 8 | get_analytics | 历史时间序列、FPS交易、造币历史、汇率变化时间线。 type param |
| 9 | get_knowledge | 所有文档和参考：常见问题解答、指南、令牌地址、链接。 topic param |
| 10 | get_news | 新闻文章、视频、用例、生态系统合作伙伴 |
| 11 | get_merch | Merch商店的产品、价格、可用性 |
| 12 | get_dune_stats | Dune Analytics——持有者数量、铸造量、随时间推移节省的TVL |
| 13 | query_ponder | 原始GraphQL逃生舱对抗美国国家航空航天局。frankencoin.com |
设计理念
- 每个工具的单一责任 --按工具返回的内容组织，而不是数据来自哪里
- 以代理为中心 --代理询问“我需要什么？”，服务器在内部聚合
- 合并自23→13 --更少的工具调用，更丰富的响应，更少的上下文浪费
______________________________________________________________________
数据源
所有数据都在服务器端聚合——代理不需要知道底层API：
| 来源 | 它提供了什么 |
|---|---|
| api.frankencoin.com | 供应、TVL、FPS、储蓄率、抵押品、挑战、价格 |
| 美国国家航空航天局 | 链上索引数据——头寸、交易、造币厂、分析 |
| CoinGecko Pro | 市场价格、24小时变化、挂钩健康、瑞士法郎稳定币比较 |
| 沙丘分析 | 持有人数量、铸造量、节省TVL历史 |
| 文档（gitbook）、网站内容（链接、媒体、令牌地址） | |
| merch.frankencoin.com | 通过Shopify API的Merch商店产品 |
______________________________________________________________________
快速开始
MCP（克劳德桌面/光标）
添加到MCP配置中：
{
"mcpServers": {
"frankencoin": {
"url": "https://mcp.frankencoin.com/mcp"
}
}
}REST API（curl/scripts）
# Full protocol snapshot
curl https://mcp.frankencoin.com/api/get_protocol_snapshot
# Market data with peg health
curl https://mcp.frankencoin.com/api/get_market_data
# Savings rates + stats
curl https://mcp.frankencoin.com/api/get_savings
# Governance activity (minters only)
curl "https://mcp.frankencoin.com/api/get_governance?type=minters&status=active"
# Positions with full detail
curl "https://mcp.frankencoin.com/api/get_positions?detail=true&limit=10"
# Historical analytics (30 days)
curl "https://mcp.frankencoin.com/api/get_analytics?type=time_series&days=30"
# Documentation
curl "https://mcp.frankencoin.com/api/get_knowledge?topic=faq"
# Raw GraphQL
curl -X POST https://mcp.frankencoin.com/api/query_ponder \
-H 'Content-Type: application/json' \
-d '{"query": "{ analyticDailyLogs(limit:3) { items { date totalSupply } } }"}'命令行界面
npx frankencoin-mcp snapshot
npx frankencoin-mcp market
npx frankencoin-mcp savings
npx frankencoin-mcp positions --detail --limit 10
npx frankencoin-mcp analytics --type trades --limit 5
npx frankencoin-mcp knowledge --topic governance
npx frankencoin-mcp ponder '{ equityTrades(limit:3) { items { kind trader shares } } }'______________________________________________________________________
自我寄宿
# Clone and install
git clone https://github.com/Frankencoin-ZCHF/frankencoin-mcp.git
cd frankencoin-mcp
npm install
# Run in HTTP mode (port 3000)
node src/index.js --http
# Or stdio mode (for MCP clients)
node src/index.js环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
PORT | 无 | HTTP端口（默认值：3000） |
COINGECKO_API_KEY | 是\* | CoinGecko Pro API密钥（用于市场数据） |
DUNE_API_KEY | 否 | Dune Analytics API密钥（用于get_Dune_stats） |
\*或放置在 ~/.config/coingecko/api_key
______________________________________________________________________
建筑
src/
├── index.js # Server entry — MCP + REST + SSE transports
├── tools.js # 13 tool definitions (names, descriptions, schemas)
├── api.js # Barrel re-export of all handlers
├── cli.js # CLI interface
└── api/
├── helpers.js # Shared: fetch helpers, constants, key loading
├── snapshot.js # get_protocol_snapshot
├── market.js # get_market_data
├── savings.js # get_savings
├── governance.js # get_governance
├── positions.js # get_positions, get_challenges, get_collaterals
├── analytics.js # get_analytics, get_dune_stats, query_ponder
└── content.js # get_knowledge, get_news, get_merch______________________________________________________________________
示例提示
“弗兰肯康协议的现状如何？” → get_protocol_snapshot“ZCHF的挂钩情况如何？与其他CHF稳定币相比。” → get_market_data“储蓄率是多少，存了多少钱？” → get_savings“向我展示最近的FPS交易和任何悬而未决的治理提案。” → get_governance“列出所有活跃头寸及其抵押品比率。” →get_positions随着detail=true
“使用弗兰肯康有什么风险？” →get_knowledge随着topic=risks
“给我看90天的协议分析。” →get_analytics随着type=time_series&days=90
______________________________________________________________________
许可证
麻省理工学院-- 弗兰肯康协会