> For the complete documentation index, see [llms.txt](https://docs.infoway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infoway.io/sdk-and-tools/mcp-server.md).

# MCP Server

### 概述

Infoway MCP Server 是基于 [Model Context Protocol](https://modelcontextprotocol.io/) 的金融数据服务器，让 Claude Desktop、Cursor 等 AI 助手可以直接在对话中查询实时金融数据。

| 项目        | 说明                                                                                  |
| --------- | ----------------------------------------------------------------------------------- |
| PyPI      | [`infoway-mcp-server`](https://pypi.org/project/infoway-mcp-server/)                |
| ClawHub   | [`infoway-financial-data`](https://clawhub.ai/infoway-api/infoway-financial-data)   |
| Python 版本 | 3.10+                                                                               |
| 传输方式      | stdio                                                                               |
| 工具数量      | 17 个                                                                                |
| GitHub    | [infoway-api/infoway-mcp-server](https://github.com/infoway-api/infoway-mcp-server) |

### 功能特点

* **17 个金融数据工具**，涵盖实时行情、K线图、市场概览、板块分析和个股基本面
* **多市场支持**：美股、港股、A股、新加坡、日本、印度 + 加密货币 + 外汇
* **零配置**：只需添加 API Key 即可开始使用
* 支持 Claude Desktop、Cursor 及所有兼容 MCP 协议的客户端

### 安装

```bash
# 使用 uvx（推荐）
uvx infoway-mcp-server

# 使用 pip
pip install infoway-mcp-server
```

### 配置

#### Claude Desktop

将以下内容添加到 Claude Desktop 配置文件：

* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
* Windows: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "infoway": {
      "command": "uvx",
      "args": ["infoway-mcp-server"],
      "env": {
        "INFOWAY_API_KEY": "你的API密钥"
      }
    }
  }
}
```

#### Cursor

添加到 Cursor MCP 配置文件（`.cursor/mcp.json`）：

```json
{
  "mcpServers": {
    "infoway": {
      "command": "uvx",
      "args": ["infoway-mcp-server"],
      "env": {
        "INFOWAY_API_KEY": "你的API密钥"
      }
    }
  }
}
```

#### Claude Code

添加到 Claude Code 配置文件（`.claude/settings.json`）：

```json
{
  "mcpServers": {
    "infoway": {
      "command": "uvx",
      "args": ["infoway-mcp-server"],
      "env": {
        "INFOWAY_API_KEY": "你的API密钥"
      }
    }
  }
}
```

### 工具列表

#### 实时行情（3个）

| 工具名                  | 说明                              |
| -------------------- | ------------------------------- |
| `get_realtime_trade` | 获取股票、加密货币、外汇的实时成交数据（价格、成交量、涨跌幅） |
| `get_market_depth`   | 获取标的买卖盘口深度数据                    |
| `get_kline`          | 获取K线（OHLCV）蜡烛图数据，支持1分钟到年线共12种周期 |

#### 市场概览（4个）

| 工具名                      | 说明                                 |
| ------------------------ | ---------------------------------- |
| `get_market_temperature` | 获取市场温度/情绪指标（0-100）                 |
| `get_market_breadth`     | 获取市场涨跌家数分布统计                       |
| `get_global_indexes`     | 获取全球主要股指实时数据（道琼斯、标普500、纳斯达克、恒生指数等） |
| `get_leading_industries` | 获取当日领涨行业板块排名                       |

#### 板块分析（4个）

| 工具名                 | 说明                        |
| ------------------- | ------------------------- |
| `get_industry_list` | 获取行业板块完整列表及涨跌数据           |
| `get_concept_list`  | 获取概念/主题板块列表（AI、新能源车、元宇宙等） |
| `get_plate_members` | 获取指定板块内的所有成分股             |
| `get_plate_heatmap` | 获取板块热力图数据，用于可视化展示         |

#### 个股基本面（5个）

| 工具名                    | 说明                            |
| ---------------------- | ----------------------------- |
| `get_company_overview` | 获取公司简介、高管、总部等基本信息             |
| `get_stock_valuation`  | 获取估值指标：PE、PB、EV/EBITDA、股息率、市值 |
| `get_stock_ratings`    | 获取分析师评级：买入/卖出/持有家数、目标价        |
| `get_stock_panorama`   | 获取个股全景数据概览                    |
| `get_stock_drivers`    | 获取影响股价的关键驱动因素分析               |

#### 工具类（1个）

| 工具名              | 说明                 |
| ---------------- | ------------------ |
| `search_symbols` | 搜索和查询可用交易品种，可按市场过滤 |

### 支持的标的格式

| 市场    | 格式        | 示例          |
| ----- | --------- | ----------- |
| 美股    | `{代码}.US` | `AAPL.US`   |
| 港股    | `{代码}.HK` | `700.HK`    |
| A股上交所 | `{代码}.SH` | `600519.SH` |
| A股深交所 | `{代码}.SZ` | `000001.SZ` |
| 加密货币  | `{交易对}`   | `BTCUSDT`   |
| 外汇    | `{货币对}`   | `USDJPY`    |

### 对话示例

> **"苹果和特斯拉现在什么价格？"** Claude 会调用 `get_realtime_trade`，标的 `AAPL.US,TSLA.US`

> **"看一下比特币最近30天的日K线"** Claude 会调用 `get_kline`，标的 `BTCUSDT`，market\_type `crypto`

> **"今天美股表现怎么样？哪些板块领涨？"** Claude 会调用 `get_market_temperature` 和 `get_leading_industries`

> **"帮我全面分析一下腾讯"** Claude 会组合调用 `get_company_overview`、`get_stock_valuation`、`get_stock_ratings`、`get_stock_drivers`

> **"对比一下英伟达和 AMD 的估值"** Claude 会分别调用 `get_stock_valuation` 查询 `NVDA.US` 和 `AMD.US`

***