stock-market-mcp-server

股票市场 MCP 服务器

功能特性

• 股票代码查询

• 实时股票价格

• 基础财务指标

• 市场和公司新闻

• 历史价格数据（K线图）

• 预置常见分析任务的提示词

环境要求

• Python 3.8 或更高版本

• uv - 快速的 Python 包安装器和解析器

• Finnhub API 密钥（可在 finnhub.io 免费获取）

• Claude Desktop（用于与 Claude 配合使用 MCP 服务器）

安装指南

1. 克隆仓库

2. 使用 uv 设置环境

3. 配置环境变量

运行 MCP 服务器

与 Claude Desktop 配合使用

1. 启动 Claude Desktop

2. 进入 Settings > Developer

3. 启用 "Developer Mode"

4. 点击 "Add Tool"

5. 选择 "Local MCP Server"

6. 配置工具：
• 名称：Stock Market
• 命令：Python 可执行文件的完整路径和脚本
• 示例：/Users/username/.venv/bin/python /Users/username/stock-market-mcp-server/stock-market-server.py
• 工作目录：项目目录的完整路径

7. 点击 "Save"

与股票市场客户端配合使用

1. 你需要一个 Anthropic API 密钥。可以在 Anthropic 免费获取。

2. 在 .env 文件中更新你的 API 密钥。ANTHROPIC_API_KEY=your_api_key_here

3. 使用以下命令启动 MCP 客户端：uv run stock_market_client.py

可用工具

• get_stock_symbol_lookup：通过公司名称搜索股票代码

• get_stock_price：获取股票的最新价格

• get_basic_financials：获取公司的关键财务指标

• get_market_news：按类别获取最新的市场新闻

• get_company_news：获取特定公司在某日期范围内的新闻

• get_stock_candles：获取股票的历史价格数据

可用提示词

• stock_analysis：分析股票的投资潜力

• market_overview：获取全面的市场概览

• stock_price_history：分析历史价格走势

• company_news_analysis：分析新闻及其对股价的影响

示例使用提示词

1. 查询股票代码： "你能帮我查一下苹果公司的股票代码吗？"

2. 获取当前股票价格： "AAPL 的当前价格是多少？"

3. 使用提示词： "我想分析一下特斯拉股票的投资潜力。"

4. 组合多个工具： "给我一个市场概览，包括最新新闻和 AAPL、MSFT、TSLA 的当前价格。"

故障排除

• API 密钥问题：确保你的 Finnhub API 密钥已正确设置在 .env.local 文件中

• 模块未找到错误：确保你已激活虚拟环境并安装了所有依赖项

• 连接问题：检查你的互联网连接和 Finnhub API 状态

许可证