Metadata-Version: 2.3
Name: liangmai-mcp
Version: 0.1.5
Summary: 量脉金融数据 MCP 服务器 — 把 255 个金融数据接口暴露为 MCP 工具，供 Claude/Cursor 等调用
Author-email: Liangmai <support@liangmai.pro>
License: MIT
Requires-Python: >=3.9
Requires-Dist: mcp<2.0.0,>=1.0.0
Requires-Dist: requests>=2.25
Description-Content-Type: text/markdown

# liangmai-mcp

量脉金融数据 MCP 服务器 —— 把量脉平台全部 **255 个金融数据接口** 暴露为 MCP 工具，供 Claude Desktop / Claude Code / Cursor / Windsurf 等 AI 客户端调用。

配置好后，你可以直接对 AI 说「查一下贵州茅台最近三个月的走势」「帮我看看今天龙虎榜」「北向资金在买什么」，AI 会自动调用量脉接口取数并回答。

---

## 1. 准备工作

1. 安装 [uv](https://docs.astral.sh/uv/)（推荐，用于 `uvx` 一键运行）；或安装 Python 3.9+ 和 pip。
2. 在量脉平台用户中心获取 **Token**。

---

## 2. 运行方式

### 方式 A：uvx（推荐，免安装）

```bash
export LIANGMAI_TOKEN=你的Token
uvx liangmai-mcp
```

### 方式 B：pip 安装后运行

```bash
pip install liangmai-mcp
export LIANGMAI_TOKEN=你的Token
liangmai-mcp
```

---

## 3. 配置到各客户端

### 3.1 Claude Desktop

编辑 `claude_desktop_config.json`（Claude Desktop → Settings → Developer → Edit Config）：

```json
{
  "mcpServers": {
    "liangmai-mcp": {
      "command": "uvx",
      "args": ["liangmai-mcp"],
      "env": {
        "LIANGMAI_TOKEN": "你的Token"
      }
    }
  }
}
```

保存后重启 Claude Desktop，工具列表里会出现 255 个 `stock_realtime`、`quote_bars_history`、`dragonTiger` 等工具。

### 3.2 Claude Code（终端）

```bash
claude mcp add liangmai-mcp --env LIANGMAI_TOKEN=你的Token -- uvx liangmai-mcp
```

### 3.3 Cursor

在项目根目录新建 `.cursor/mcp.json`：

```json
{
  "mcpServers": {
    "liangmai-mcp": {
      "command": "uvx",
      "args": ["liangmai-mcp"],
      "env": {
        "LIANGMAI_TOKEN": "你的Token"
      }
    }
  }
}
```

重启 Cursor 后即可在 AI 对话中使用。

### 3.4 Windsurf

在 `~/.codeium/windsurf/mcp_config.json` 中添加同上配置。

---

## 4. 使用示例

配置完成后，直接自然语言提问：

- 「查一下 600519 的实时行情」
- 「看下宁德时代最近三个月的日线走势」
- 「今天涨停股池有哪些」
- 「查平安银行的资产负债表」
- 「北向资金最近在买什么」
- 「今天龙虎榜上机构和游资买了什么」

AI 会自动选择合适的工具（接口）并传参取数。

---

## 5. 环境变量

| 变量 | 必填 | 说明 |
| --- | --- | --- |
| `LIANGMAI_TOKEN` | 是 | 平台 Token，在量脉用户中心获取 |
| `LIANGMAI_BASE_URL` | 否 | 网关地址，默认 `https://liangmai.pro/api/gateway` |

---

## 6. 本地开发

```bash
git clone <仓库地址>
cd liangmai-mcp
pip install -e .
export LIANGMAI_TOKEN=你的Token
liangmai-mcp
```

工具由 `tools/gen_liangmai_mcp.php` 从平台配置自动生成，接口变更后重跑即可同步。
