金融数据API服务器

Alpha Vantage MCP服务器

一种模型上下文协议（MCP）服务器，提供对Alpha Vantage财务数据API的访问，供Claude Desktop和其他MCP兼容应用程序使用。

🚀 特性

• 股票数据：实时报价和历史每日价格
• 财务报表：损益表、资产负债表和现金流量表
• 公司信息：公司概况和盈利数据
• 新闻与情绪：最新财经新闻与情绪分析
• 错误处理：强大的API错误处理和速率限制管理

📋 先决条件

1. Alpha Vantage API密钥：从获取您的免费API密钥 阿尔法Vantage
2. Python 3.8+：确保你安装了Python
3. 克劳德桌面：或其他与MCP兼容的应用程序

🛠️ 安装

1.克隆存储库

git clone https://github.com/yourusername/alphavantage-mcp-server.git
cd alphavantage-mcp-server

2.安装依赖项

pip install -r requirements.txt

3.获取API密钥

1. 访问 阿尔法Vantage
2. 注册一个免费帐户
3. 复制API密钥

⚙️ 配置

适用于克劳德桌面

将此配置添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "alphavantage": {
      "command": "python3",
      "args": ["/path/to/alphavantage_server.py"],
      "env": {
        "ALPHAVANTAGE_API_KEY": "your_actual_api_key_here"
      }
    }
  }
}

重要：替换 /path/to/alphavantage_server.py 与脚本的实际路径和 your_actual_api_key_here 使用您的Alpha Vantage API密钥。

🎯 使用示例

配置后，您可以询问Claude：

• “获取苹果（AAPL）的当前股票报价”
• “显示Microsoft的最新损益表”
• “特斯拉股票的最新消息是什么？”
• “获取亚马逊的资产负债表数据”
• “给我看看谷歌的现金流量表”

📊 可用功能

🔧 测试

通过直接运行服务器来测试您的安装：

export ALPHAVANTAGE_API_KEY="your_api_key"
python3 alphavantage_server.py

服务器应无错误地启动。按 Ctrl+C 停止。

📝 API限值

• 免费等级：高级端点每天25个请求，标准端点每天500个请求
• 速率限制：5个电话/分钟
• 高级级别：适用于更高的限制

🐛 故障排除

常见问题

1. “服务器已断开连接”错误

   • 检查您的API密钥是否正确
   • 验证配置中的文件路径
   • 确保已安装依赖项

2. “ModuleNotFoundError:没有名为'mcp'的模块”

   • 安装依赖项： pip install -r requirements.txt
   • 在配置中使用正确的Python路径

3. API速率限制错误

   • 您已超过免费等级限制
   • 等待费率限制重置或升级您的计划

🤝 贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• 阿尔法Vantage 用于提供财务数据API
• Anthropic 用于创建模型上下文协议
• MCP工具和文档社区

📞 支持

如果您遇到任何问题或有疑问：

1. 检查 故障排除部分
2. 搜索现有 GitHub问题
3. 使用有关您问题的详细信息创建新问题