使用说明

项目简介

claude-test 项目是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型 (LLM) 提供访问股票市场数据的能力。该服务器通过集成 Marketstack API，使得 LLM 能够查询股票的日终 (End-of-Day, EOD) 报价，从而扩展 LLM 在金融数据分析和应用方面的能力。

主要功能点

获取日终股票数据: 支持查询指定股票代码在特定日期范围内的日终报价，包括开盘价、最高价、最低价、收盘价、交易量等详细信息。
数据过滤: 允许用户通过指定开始日期和结束日期来过滤查询结果，获取特定时间段内的股票数据。
错误处理: 能够处理API请求错误和速率限制，并向用户返回清晰的错误信息。
易于配置和使用: 通过简单的 JSON 配置即可集成到 MCP 客户端（如 Claude），并提供清晰的使用示例。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm。
获取 Marketstack API 密钥: 访问 marketstack.com/signup 注册并获取免费的 API 密钥（可能需要信用卡信息）。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（以 Claude Desktop 为例），你需要在客户端的配置文件 'claude_desktop_config.json' 中添加服务器配置信息。以下是针对 'claude-test' 项目的配置示例：

{
  "mcpServers": {
    "marketstack": {  // 服务器名称，可以自定义，例如 "marketstack"
      "command": "npx",  // 启动服务器的命令，这里使用 npx 运行 npm 包
      "args": [
        "-y",
        "@shussey/marketstack" //  要运行的 npm 包名称，根据仓库信息，推测是作者将此项目发布到了 npm 上，包名为 @shussey/marketstack
      ],
      "env": {
        "MARKETSTACK_API_KEY": "<YOUR_API_KEY>"  // 环境变量，用于传递 Marketstack API 密钥，请替换为你在 Marketstack 注册获得的 API 密钥
      }
    }
  }
}

请将 '<YOUR_API_KEY>' 替换为你从 Marketstack 网站获取的 API 密钥。

注意： 根据仓库 'README.md' 和代码内容，推测该 MCP 服务器可能已经被作者打包并发布到了 npm 上，包名为 '@shussey/marketstack'。因此，上述配置直接使用了 'npx' 命令来运行 npm 包，而没有使用本地文件路径。用户无需手动下载仓库代码和构建，只需配置好 API 密钥即可使用。

基本使用方法

配置完成后，你就可以在 MCP 客户端中通过自然语言指令来查询股票数据了。例如，在 Claude 中，你可以这样提问：

"What was Apple's stock price last week?" (苹果股票上周的价格是多少？)
"Get me the EOD data for Google from 2024-11-20 to 2024-11-25." (获取谷歌股票从 2024-11-20 到 2024-11-25 的日终数据。)

Claude (或其他 MCP 客户端) 将解析你的问题，调用配置的 'marketstack' MCP 服务器，并使用 'marketstack_eod' 工具来获取股票数据，最终将结果返回给你。

预期交互示例 (来自仓库 README.md):

用户提问: "What was Apple's stock price last week?"

Claude 可能会展示类似如下的交互:

I'll help you check Apple's stock price data from last week using the marketstack API.

View Result from marketstack_eod from marketstack (local)
{
  'symbol': 'AAPL',
  'date_to': '2024-11-30',
  'date_from': '2024-11-24'
}
{
  "content": [
    // ... (JSON 格式的股票数据) ...
  ],
  "isError": false
}

Based on the data, here's Apple's stock performance last week:

- Monday (Nov 25): Opened at $231.46, closed at $232.87
- Tuesday (Nov 26): Opened at $233.48, closed at $235.06
- Wednesday (Nov 27): Opened at $234.47, closed at $234.93
- Friday (Nov 29): Opened at $234.81, closed at $237.33

// ... (对股票数据的文本总结) ...

通过以上步骤，你就可以利用 claude-test 仓库提供的 MCP 服务器，让你的 LLM 具备查询股票市场数据的能力。

关键词