MacroMicro MCP服务器-官方文档
概述
MacroMicro MCP服务器为Claude提供了对MacroMicro的实时访问，MacroMicro是一个全面的金融和经济数据分析平台。这使克劳德能够用最新信息和专业等级分析回答有关经济指标、市场趋势和财务数据的问题。
服务器名称：宏微MCP服务器 版本: 1.0 协议：MCP（模型上下文协议） 运输：HTTP（流式HTTP） 部署：AWS Lambda（Python 3.13）
什么是MacroMicro？
MacroMicro是一个金融数据分析平台，提供：
- 实时经济指标和市场数据
- 跨国经济比较
- 历史财务数据分析
- 市场趋势可视化和洞察
- 专业级金融研究工具
能力
工具： ask_MacroMicro
描述：将有关金融和经济数据的自然语言问题发送到MacroMicro平台。
参数:
question（string，必填）：关于金融市场、经济指标或数据分析的自然语言问题
退货：一个markdown格式的响应，包含：
- 对问题的直接回答
- 相关数据点和统计数据
- 图表和可视化（如markdown）
- 历史背景和分析
- 数据来源和参考
响应时间：由于平台执行全面的数据分析和图表生成，查询通常需要40-60秒。
示例用例
- 经济分析
- “与历史平均水平相比，美国通胀率的当前趋势是什么？” - “中国的GDP增长与其他主要经济体相比如何？”
- 市场调研
- “全球半导体需求的最新趋势是什么？” - “美联储的利率政策对债券收益率有何影响？”
- 投资洞察
- “油价与能源行业表现之间的相关性是什么？” - “让我看看标准普尔500指数在经济衰退期间的历史波动性”
- 比较分析
- “比较过去5年七国集团国家的失业率” - “房价和利率之间有什么关系？”
目标用户
此MCP服务器设计用于：
- 财务分析师：需要快速获取经济数据和趋势的专业人员
- 投资者：研究市场状况的个人和机构投资者
- 经济学家：研究人员分析宏观经济指标
- 商业领袖：高管们做出数据驱动的战略决策
- 学生和教育工作者：那些学习经济学和金融市场的人
安装说明
安全与隐私
数据处理
- 无数据存储：服务器不存储任何用户查询或响应
- 无状态设计：每个请求都是独立的，没有会话状态
- 直接代理：问题直接转发给MacroMicro API；响应按原样返回
- 不记录内容：仅维护系统级日志（时间戳、成功/失败）
API安全
- 环境变量：API凭据作为Lambda环境变量安全存储
- 仅限HTTPS：所有通信都使用加密的HTTPS连接
- 请求超时：90秒超时可防止挂起连接
- 错误处理：敏感错误详细信息不会暴露给最终用户
保密考虑
- 用户问题将发送给MacroMicro进行处理
- MacroMicro可能有自己的数据保留政策
- 此服务器不会收集任何个人身份信息（PII）
- 建议与最终用户一起查看MacroMicro的隐私政策
技术架构
组件
- FastMCP框架：提供MCP协议实现
- AWS Lambda：用于可扩展性的无服务器计算平台
- Python 3.13：性能得到改善的现代Python运行时
- 乌维科恩/ASGI：高性能异步HTTP服务器
- 请求库：用于MacroMicro API集成的HTTP客户端
请求流
Claude Client → MCP Protocol → AWS Lambda (this server) → MacroMicro API
↓
Claude Client ← Markdown Response ← AWS Lambda ← MacroMicro API响应格式
MacroMicro的所有回复均采用markdown格式，可能包含：
- 文本解释和分析
- 嵌入式图表参考
- 数据表
- 要点摘要
- 数据源引用
重要：客户端应保留并呈现markdown格式，以获得最佳用户体验。
错误处理
服务器优雅地处理常见错误场景：
- 超时错误：如果MacroMicro需要>90秒，则返回用户友好的超时消息
- API不可用：如果MacroMicro宕机，则返回错误而不暴露内部详细信息
- 无效请求：验证输入并返回明确的错误消息
- 配置错误：启动时检查所需的环境变量
演出
- 冷启动：约2-3秒（Lambda容器初始化）
- 温馨请求：\<100ms（仅服务器处理）
- MacroMicro查询：40-50秒（数据分析和图表生成）
- 总响应时间：典型值为40-60秒
局限性
- 查询复杂性：非常复杂的查询可能会超时90秒
- 速率限制：受MacroMicro API费率限制（如有）
- 数据货币：数据新鲜度取决于MacroMicro的更新计划
- 语言：目前支持英语查询
- 地理数据：关注主要经济体和市场
支持与维护
- 源代码：可在GitHub上找到（提供链接）
- 问题：通过GitHub问题报告
- 更新：服务器是无状态的；更新需要重新部署Lambda函数
- 监控：管理员可以使用CloudWatch日志
许可和归属
此MCP服务器是使用以下方式构建的：
- FastMCP开源MCP框架(MIT许可证)
- AWS Lambda：亚马逊网络服务无服务器平台
- 宏微：金融数据平台（需要单独的许可证/订阅）
更新日志
版本1.0（当前）
- 初始版本
- 单一工具：
ask_MacroMicro - AWS Lambda部署
- 无状态模式的HTTP传输
- 长时间运行的查询超时90秒
联系
关于以下问题：
- 技术问题: phil@macromicro.me
- 一般问题: support@macromicro.me
______________________________________________________________________
*该服务器旨在将财务数据功能集成到Claude中，使用户能够通过自然语言对话获得实时、专业级的经济和市场分析。*