AI导哈

股票价格查询服务

一个提供实时股票价格数据的MCP服务器，可从Yahoo Finance获取数据并与Claude Desktop集成，支持查询主要股票符号的当前价格、变化、日高/低和交易量。

  • by amillerrr
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 amillerrr/stock-price-mcp

使用说明

股票价格MCP服务器

一个模型上下文协议（MCP）服务器，提供来自雅虎财经的实时股价数据。此服务器与Claude Desktop集成，允许您在对话中直接查询当前股票价格。

特性

  • 雅虎财经的实时股价数据
  • Docker化，易于部署
  • 与Claude Desktop兼容
  • 支持主要股票品种（AAPL、GOOGL、MSFT、TSLA等）
  • 返回当前价格、变化、日高/低和交易量

快速开始

1.构建Docker镜像

# Clone or navigate to the project directory
cd stock-price-mcp

# Build the Docker image
docker build -t stock-price-mcp:latest .

2.测试服务器

直接用Docker测试MCP服务器：

# Test initialization
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | docker run -i --rm stock-price-mcp:latest

# Test tools list
echo '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | docker run -i --rm stock-price-mcp:latest

# Test getting Apple stock price
echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_stock_price","arguments":{"symbol":"AAPL"}}}' | docker run -i --rm stock-price-mcp:latest

# Test other stocks
echo '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"get_stock_price","arguments":{"symbol":"GOOGL"}}}' | docker run -i --rm stock-price-mcp:latest

3.配置克劳德桌面

选项A：使用提供的配置文件

从以下位置复制配置 config/mcp-config.json 到您的Claude Desktop配置：

Claude桌面配置的位置：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json

复制内容：

{
  "mcpServers": {
    "stock-price-checker": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "stock-price-mcp:latest"
      ],
      "env": {}
    }
  }
}

选项B：添加到现有配置

如果您已经配置了其他MCP服务器，请添加 stock-price-checker 部分到您现有的 mcpServers 对象。

4.重新启动克劳德桌面

更新配置后，完全退出并重新启动Claude Desktop以使更改生效。

用法

配置后，您可以用自然语言向Claude询问股票价格：

  • “苹果目前的股价是多少？”
  • “给我GOOGL的价格”
  • “给我看看特斯拉的股价”
  • “微软现在的交易价格是多少？”

支持的股票代码

该服务器适用于雅虎财经上可用的任何有效股票代码，包括：

  • 技术： AAPL、GOOGL、MSFT、TSLA、NVDA、META、AMZN
  • 财务： JPM、BAC、WFC、GS
  • 医疗保健： JNJ、PFE、UNH、ABBV
  • 还有更多。..

项目结构

stock-price-mcp/
├── main.go              # MCP server implementation
├── go.mod               # Go module file
├── Dockerfile           # Multi-stage Docker build
├── docker-compose.yml   # Docker Compose configuration
├── config/
│   └── mcp-config.json  # Claude Desktop configuration
└── README.md           # This file

发展

本地开发（无Docker）

# Build locally
go build -o stock-price-mcp

# Test locally
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | ./stock-price-mcp

使用Docker Compose

# Start the service
docker-compose up -d

# View logs
docker-compose logs -f stock-price-mcp

# Stop the service
docker-compose down

故障排除

常见问题

  1. Claude Desktop中“无可用工具”

    • 确保Docker镜像已构建： docker build -t stock-price-mcp:latest .
    • 验证Claude Desktop配置是否正确
    • 完全重新启动克劳德桌面

  2. “无法获取数据”错误

    • 检查互联网连接
    • 验证股票代码是否有效
    • 雅虎财经可能会暂时阻止请求

  3. Docker构建失败

    • 确保你的Dockerfile中有Go 1.21+
    • 检查所有文件是否都在正确的目录中

测试配置

验证您的配置是否正常工作：

# Test that Docker can run the image
docker run --rm stock-price-mcp:latest --help

# Test JSON-RPC communication
docker run -i --rm stock-price-mcp:latest < config/test-request.json

技术细节

  • 语言： 转到1.25+
  • 协议： 基于stdio的JSON-RPC 2.0
  • 数据来源： 雅虎财经API

许可证

本项目按原样提供，供教育和个人使用。

贡献

请随时提交问题和增强请求。

相关 MCP