Metadata-Version: 2.4
Name: matrix-api-mcp
Version: 1.1.2
Summary: MatriX MCP 工具层（AI 助手接入金融数据查询）
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: matrix-api>=1.1.0
Requires-Dist: mcp>=2.3
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# MatriX MCP
V1.1.2-Beta Build 20261105

© 2026-2026 Xu Rendong. All Rights Reserved.

### Project Summary
MatriX 金融数据 MCP 工具层：让 AI 助手（Trae / Claude Code / Cursor / WorkBuddy / Codex 等）直接查询量化金融数据，自动控制返回规模。依赖 matrix-api（pip 安装本包时自动带上）。

### AI Agent 自动部署指引（Agent 请照此执行）

用户要求"安装 / 使用 matrix-api-mcp"时，按以下步骤操作，用户无需手工编辑任何配置文件：

1. 安装本包（用目标机器的 Python）：
   ```
   python -m pip install matrix-api-mcp
   ```
2. 向用户询问两个信息（切勿编造或留空）：MatriX 数据服务地址（形如 `http://host:port`）与认证 token。
3. 执行一键配置，`--ide` 按用户所用 IDE 选择 `trae` / `claude` / `cursor` / `workbuddy` / `codex`：
   ```
   python -m matrix_mcp install --ide trae --base-url http://127.0.0.1:8100 --token mx-xxxxxxxx
   ```
   - `trae` / `claude` 为**项目级**配置，须在用户项目根目录执行（可用 `--project-dir` 指定）；其余为**用户级**全局配置。
   - 命令幂等可重复执行；写入前自动备份 `.bak`，不影响已配置的其他 MCP server。
4. 告知用户重启对应 IDE 后生效。

### 手工配置参考

不想用 install 子命令时，可将下方条目合并进 IDE 的 MCP 配置（`command` 换成实际 Python 绝对路径）：

```json
{
  "mcpServers": {
    "matrix": {
      "command": "D:\\Python310\\python.exe",
      "args": ["-m", "matrix_mcp"],
      "env": {
        "MATRIX_API_URL": "http://127.0.0.1:8100",
        "MATRIX_TOKEN": "mx-你的认证码",
        "PYTHONUTF8": "1"
      }
    }
  }
}
```

Codex（`~/.codex/config.toml`）对应形态：

```toml
[mcp_servers.matrix]
command = 'D:\Python310\python.exe'
args = ["-m", "matrix_mcp"]
env = { MATRIX_API_URL = "http://127.0.0.1:8100", MATRIX_TOKEN = "mx-你的认证码", PYTHONUTF8 = "1" }
```

### Contact Information
WeChat：xrd_ustc，~~QQ：277195007~~，~~E-mail：xrd@ustc.edu~~
