Finance Tools Mcp

finance-tools-mcp：金融分析 MCP 服务

https://github.com/VoxLink-org/finance-tools-mcp

概述

finance-tools-mcp 是一种模型上下文协议（MCP）服务，旨在为大语言模型（LLM）提供全面的金融洞察和分析能力。它基于 investor-agent 修改而来，整合了多种数据源和分析库，提供一套用于深入金融研究和分析的工具。

前置要求

• Python： 需要 3.10 或更高版本。
• 包管理器： uv 是本项目推荐的包安装和解析工具。

安装

如果尚未安装 uv，请先安装：

curl -LsSf https://astral.sh/uv/install.sh | sh

确保 uv 位于系统的 PATH 中。你可能需要重启终端，或将 ~/.cargo/bin 添加到 PATH 中。

然后，你可以使用 uvx 运行 finance-tools-mcp MCP 服务（uvx 无需将软件包显式安装到环境中即可运行它）：

uvx finance-tools-mcp

如需使用 FRED API 密钥运行服务（以增强宏观经济数据访问能力），请将其设置为环境变量：

FRED_API_KEY=YOUR_API_KEY uvx finance-tools-mcp

你也可以使用服务器发送事件（SSE）传输方式运行服务，部分 MCP 客户端可能更倾向于使用这种方式：

uvx finance-tools-mcp --transport sse

也可以同时使用 FRED API 密钥和 SSE 传输方式：

FRED_API_KEY=YOUR_API_KEY uvx finance-tools-mcp --transport sse

在 MCP 客户端中使用

如需将 finance-tools-mcp 集成到 MCP 客户端（例如 Claude Desktop），请将以下配置添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "investor": {
        "command": "path/to/uvx/command/uvx",
        "args": ["finance-tools-mcp"],
    }
  }
}

调试

你可以使用 MCP 检查器调试服务：

npx @modelcontextprotocol/inspector uvx finance-tools-mcp

或

npx @modelcontextprotocol/inspector uv --directory  ./ run finance-tools-mcp

如需监控日志，请查看以下目录：

• macOS：~/Library/Logs/Claude/mcp*.log
• Windows：%APPDATA%\Claude\logs\mcp*.log

开发

本地开发和测试：

1. 按照调试部分中的说明使用 MCP 检查器。
2. 使用以下配置通过 Claude Desktop 进行测试：

{
  "mcpServers": {
    "investor": {
      "command": "path/to/uv/command/uv",
      "args": ["--directory", "path/to/finance-tools-mcp", "run", "finance-tools-mcp"],
    }
  }
}