关键词

市场数据金融数据股票外汇加密货币API工具Twelve Data

本项目是一个基于Model Context Protocol (MCP)实现的服务器，旨在将Twelve Data API提供的金融市场数据和功能暴露给LLM（大型语言模型）客户端。通过标准的MCP接口，LLM应用可以方便地获取股票、外汇、加密货币等的实时和历史数据。

主要功能点

  • 获取历史时间序列数据: 根据股票代码、时间间隔、开始/结束日期等参数，获取OHLCV（开盘价、最高价、最低价、收盘价、交易量）等历史价格数据。
  • 获取最新价格: 查询指定股票、外汇对或加密货币的最新交易价格。
  • 查询股票列表: 获取所有可交易的股票列表，支持按交易所过滤。
  • 查询外汇对列表: 获取所有可交易的外汇货币对列表。
  • 查询加密货币列表: 获取所有可交易的加密货币列表。

安装步骤

推荐使用 'uv' 工具进行安装和运行，无需本地完整安装。

  1. 使用 'uv' (推荐) 如果您已安装 'uv'，可以直接使用 'uvx' 运行：

    uvx mcp-server-twelve-data --help

  2. 使用 'pip' 如果您更喜欢使用 'pip'，可以先安装包，然后运行：

    pip install mcp-server-twelve-data
python -m mcp_server_twelve_data --help

服务器配置

此MCP服务器是为MCP客户端（如Claude Desktop或支持MCP的VS Code扩展）提供服务的。您需要在您的MCP客户端中配置此服务器以便连接。

配置信息通常是一个JSON对象，包含一个服务器名称（例如 ''twelvedata''），以及启动此服务器的命令（'command'）及其参数（'args'）。

  • command: 启动服务器的命令，例如 'uvx mcp-server-twelve-data' 或 'python -m mcp_server_twelve_data'。
  • args: 传递给启动命令的参数列表。最重要的参数是您的Twelve Data API密钥。
    • '--apikey YOUR_API_KEY': 用于设置您的Twelve Data API密钥。请将 'YOUR_API_KEY' 替换为您的实际密钥。
    • '-t streamable-http' 或 '-t stdio': 指定服务器使用的传输协议，应与客户端的配置匹配。

例如，在Claude Desktop的配置中，您可能需要添加类似以下的信息（请注意，这是描述配置内容，不是实际的代码块）：

"mcpServers": {
  "twelvedata": {
    "command": "uvx", // 或 python -m mcp_server_twelve_data
    "args": [
      "mcp-server-twelve-data",
      "--apikey",
      "您的实际API密钥",
      "-t", // 可选，指定传输协议
      "streamable-http" // 或 stdio
    ]
  }
}

基本使用方法

  1. 确保您已安装并配置好支持MCP的LLM客户端（如Claude Desktop或相关VS Code扩展）。
  2. 在MCP客户端的配置中，添加并正确设置此 Twelve Data MCP 服务器的启动命令和API密钥。
  3. 启动您的MCP客户端。客户端会自动尝试连接和发现配置的MCP服务器。
  4. 一旦连接成功，LLM客户端将能够识别并使用此服务器提供的工具（如查询股票价格、历史数据等）。您可以通过与LLM对话或使用客户端界面来触发这些工具的使用。

信息

分类

网页与API

访问项目