qlib-sync 0.1.0__tar.gz → 0.1.1__tar.gz

{qlib_sync-0.1.0 → qlib_sync-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: qlib-sync
-Version: 0.1.0
+Version: 0.1.1
 Summary: Safely install and update a local Qlib China A-share dataset, with an MCP server for AI assistants.
 Project-URL: Homepage, https://github.com/randyy179/qlib-sync
 Project-URL: Issues, https://github.com/randyy179/qlib-sync/issues
@@ -46,7 +46,9 @@ pip install qlib-sync
 qlib-sync cn update
 ```
 
-Or without installing anything first: `uvx qlib-sync cn update`.
+Or without installing anything first: `uvx --python 3.12 qlib-sync cn update`.
+(`--python 3.12` because pyqlib publishes wheels up to Python 3.12; uv fetches that Python
+for you if needed. With pip, use Python 3.10 to 3.12.)
 
 ![qlib-sync updating the dataset: status, download with progress, checksum, summary, then an instant no-op](https://raw.githubusercontent.com/randyy179/qlib-sync/main/docs/assets/demo-update.gif)
 
@@ -150,17 +152,17 @@ Every client needs the same two things: the command `uvx` and the arguments `qli
 | Client | How to add qlib-sync |
 |---|---|
 | Claude Desktop | Download `qlib-sync.mcpb` from the [latest release](https://github.com/randyy179/qlib-sync/releases/latest) and open it |
-| Claude Code | `claude mcp add qlib-sync -- uvx qlib-sync mcp` |
-| OpenAI Codex CLI | `codex mcp add qlib-sync -- uvx qlib-sync mcp` |
+| Claude Code | `claude mcp add qlib-sync -- uvx --python 3.12 qlib-sync mcp` |
+| OpenAI Codex CLI | `codex mcp add qlib-sync -- uvx --python 3.12 qlib-sync mcp` |
 | Cursor | The JSON below, in `~/.cursor/mcp.json` |
 | Gemini CLI | The JSON below, in `~/.gemini/settings.json` |
 | Qwen Code | The JSON below, in `~/.qwen/settings.json` |
 | Tencent CodeBuddy, ByteDance Trae, Alibaba Tongyi Lingma | MCP settings, add a server manually, paste the JSON below |
-| Cherry Studio | Settings, MCP servers, add: type STDIO, command `uvx`, arguments `qlib-sync` and `mcp` on separate lines |
-| VS Code (Copilot agent mode) | `.vscode/mcp.json`: `{ "servers": { "qlib-sync": { "type": "stdio", "command": "uvx", "args": ["qlib-sync", "mcp"] } } }` |
+| Cherry Studio | Settings, MCP servers, add: type STDIO, command `uvx`, arguments `--python`, `3.12`, `qlib-sync`, `mcp` on separate lines |
+| VS Code (Copilot agent mode) | `.vscode/mcp.json`: `{ "servers": { "qlib-sync": { "type": "stdio", "command": "uvx", "args": ["--python", "3.12", "qlib-sync", "mcp"] } } }` |
 
 ```json
-{ "mcpServers": { "qlib-sync": { "command": "uvx", "args": ["qlib-sync", "mcp"] } } }
+{ "mcpServers": { "qlib-sync": { "command": "uvx", "args": ["--python", "3.12", "qlib-sync", "mcp"] } } }
 ```
 
 Menu names and file locations change between versions; check your client's MCP documentation

{qlib_sync-0.1.0 → qlib_sync-0.1.1}/README.md

@@ -17,7 +17,9 @@ pip install qlib-sync
 qlib-sync cn update
 ```
 
-Or without installing anything first: `uvx qlib-sync cn update`.
+Or without installing anything first: `uvx --python 3.12 qlib-sync cn update`.
+(`--python 3.12` because pyqlib publishes wheels up to Python 3.12; uv fetches that Python
+for you if needed. With pip, use Python 3.10 to 3.12.)
 
 ![qlib-sync updating the dataset: status, download with progress, checksum, summary, then an instant no-op](docs/assets/demo-update.gif)
 
@@ -121,17 +123,17 @@ Every client needs the same two things: the command `uvx` and the arguments `qli
 | Client | How to add qlib-sync |
 |---|---|
 | Claude Desktop | Download `qlib-sync.mcpb` from the [latest release](https://github.com/randyy179/qlib-sync/releases/latest) and open it |
-| Claude Code | `claude mcp add qlib-sync -- uvx qlib-sync mcp` |
-| OpenAI Codex CLI | `codex mcp add qlib-sync -- uvx qlib-sync mcp` |
+| Claude Code | `claude mcp add qlib-sync -- uvx --python 3.12 qlib-sync mcp` |
+| OpenAI Codex CLI | `codex mcp add qlib-sync -- uvx --python 3.12 qlib-sync mcp` |
 | Cursor | The JSON below, in `~/.cursor/mcp.json` |
 | Gemini CLI | The JSON below, in `~/.gemini/settings.json` |
 | Qwen Code | The JSON below, in `~/.qwen/settings.json` |
 | Tencent CodeBuddy, ByteDance Trae, Alibaba Tongyi Lingma | MCP settings, add a server manually, paste the JSON below |
-| Cherry Studio | Settings, MCP servers, add: type STDIO, command `uvx`, arguments `qlib-sync` and `mcp` on separate lines |
-| VS Code (Copilot agent mode) | `.vscode/mcp.json`: `{ "servers": { "qlib-sync": { "type": "stdio", "command": "uvx", "args": ["qlib-sync", "mcp"] } } }` |
+| Cherry Studio | Settings, MCP servers, add: type STDIO, command `uvx`, arguments `--python`, `3.12`, `qlib-sync`, `mcp` on separate lines |
+| VS Code (Copilot agent mode) | `.vscode/mcp.json`: `{ "servers": { "qlib-sync": { "type": "stdio", "command": "uvx", "args": ["--python", "3.12", "qlib-sync", "mcp"] } } }` |
 
 ```json
-{ "mcpServers": { "qlib-sync": { "command": "uvx", "args": ["qlib-sync", "mcp"] } } }
+{ "mcpServers": { "qlib-sync": { "command": "uvx", "args": ["--python", "3.12", "qlib-sync", "mcp"] } } }
 ```
 
 Menu names and file locations change between versions; check your client's MCP documentation

{qlib_sync-0.1.0 → qlib_sync-0.1.1}/README.zh-CN.md

@@ -11,7 +11,8 @@ pip install qlib-sync
 qlib-sync cn update
 ```
 
-也可以不预先安装，直接运行：`uvx qlib-sync cn update`。
+也可以不预先安装，直接运行：`uvx --python 3.12 qlib-sync cn update`。
+（加 `--python 3.12` 是因为 pyqlib 只提供到 Python 3.12 的安装包，需要时 uv 会自动下载这个版本的 Python。用 pip 安装时请使用 Python 3.10 到 3.12。）
 
 ![qlib-sync 更新数据：查看状态、带进度下载、校验、汇报变化，再运行一次瞬间完成](docs/assets/demo-update.gif)
 
@@ -99,17 +100,17 @@ MCP server 在你本机运行，读取你电脑上的数据，不需要搭建任
 | 工具 | 接入方式 |
 |---|---|
 | Claude Desktop | 从[最新发布](https://github.com/randyy179/qlib-sync/releases/latest)下载 `qlib-sync.mcpb`，双击安装 |
-| Claude Code | `claude mcp add qlib-sync -- uvx qlib-sync mcp` |
-| OpenAI Codex CLI | `codex mcp add qlib-sync -- uvx qlib-sync mcp` |
+| Claude Code | `claude mcp add qlib-sync -- uvx --python 3.12 qlib-sync mcp` |
+| OpenAI Codex CLI | `codex mcp add qlib-sync -- uvx --python 3.12 qlib-sync mcp` |
 | 腾讯 CodeBuddy、字节 Trae、阿里通义灵码 | 在 MCP 设置里手动添加服务器，粘贴下面的 JSON |
-| Cherry Studio | 设置 → MCP 服务器 → 添加：类型选 STDIO，命令填 `uvx`，参数分两行填 `qlib-sync` 和 `mcp` |
+| Cherry Studio | 设置 → MCP 服务器 → 添加：类型选 STDIO，命令填 `uvx`，参数分四行填 `--python`、`3.12`、`qlib-sync`、`mcp` |
 | 通义千问 Qwen Code | 把下面的 JSON 写进 `~/.qwen/settings.json` |
 | Cursor | 把下面的 JSON 写进 `~/.cursor/mcp.json` |
 | Gemini CLI | 把下面的 JSON 写进 `~/.gemini/settings.json` |
-| VS Code（Copilot Agent 模式） | `.vscode/mcp.json`：`{ "servers": { "qlib-sync": { "type": "stdio", "command": "uvx", "args": ["qlib-sync", "mcp"] } } }` |
+| VS Code（Copilot Agent 模式） | `.vscode/mcp.json`：`{ "servers": { "qlib-sync": { "type": "stdio", "command": "uvx", "args": ["--python", "3.12", "qlib-sync", "mcp"] } } }` |
 
 ```json
-{ "mcpServers": { "qlib-sync": { "command": "uvx", "args": ["qlib-sync", "mcp"] } } }
+{ "mcpServers": { "qlib-sync": { "command": "uvx", "args": ["--python", "3.12", "qlib-sync", "mcp"] } } }
 ```
 
 各工具的菜单名称和配置文件位置会随版本变化，找不到时以该工具的 MCP 官方文档为准。已实测：Claude Code、OpenAI Codex CLI。

{qlib_sync-0.1.0 → qlib_sync-0.1.1}/mcpb/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.4",
   "name": "qlib-sync",
   "display_name": "qlib-sync: China A-share data",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Install, update, and read a local Qlib China A-share daily dataset.",
   "long_description": "Keeps ~/.qlib/qlib_data/cn_data current with the daily community release from chenditc/investment_data, with checksum verification and automatic rollback, and lets Claude read daily prices and index constituents from it. The first update downloads about 550 MB.",
   "author": {

{qlib_sync-0.1.0 → qlib_sync-0.1.1}/mcpb/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "qlib-sync-mcpb"
-version = "0.1.0"
+version = "0.1.1"
 description = "Claude Desktop bundle for qlib-sync"
 requires-python = ">=3.10,<3.13"
-dependencies = ["qlib-sync==0.1.0"]
+dependencies = ["qlib-sync==0.1.1"]

{qlib_sync-0.1.0 → qlib_sync-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "qlib-sync"
-version = "0.1.0"
+version = "0.1.1"
 description = "Safely install and update a local Qlib China A-share dataset, with an MCP server for AI assistants."
 dynamic = ["readme"]
 requires-python = ">=3.10,<3.13"

{qlib_sync-0.1.0 → qlib_sync-0.1.1}/server.json

@@ -7,15 +7,22 @@
     "url": "https://github.com/randyy179/qlib-sync",
     "source": "github"
   },
-  "version": "0.1.0",
+  "version": "0.1.1",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "qlib-sync",
-      "version": "0.1.0",
+      "version": "0.1.1",
       "runtimeHint": "uvx",
-      "packageArguments": [{ "type": "positional", "value": "mcp" }],
-      "transport": { "type": "stdio" },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ],
+      "transport": {
+        "type": "stdio"
+      },
       "environmentVariables": [
         {
           "name": "QLIB_SYNC_DATA_DIR",
@@ -27,6 +34,13 @@
           "description": "Optional prefix-style GitHub proxy for slow connections, e.g. https://ghfast.top",
           "isRequired": false
         }
+      ],
+      "runtimeArguments": [
+        {
+          "type": "named",
+          "name": "--python",
+          "value": "3.12"
+        }
       ]
     }
   ]

{qlib_sync-0.1.0 → qlib_sync-0.1.1}/skills/qlib-sync/SKILL.md

@@ -14,7 +14,7 @@ so running an update is always safe.
 ## Pick the interface
 
 - **MCP tools available** (`cn_status`, `cn_update`, `cn_get_prices`, ...): use them directly.
-- **Otherwise** use the CLI. If `qlib-sync` is not installed, `uvx qlib-sync ...` runs it
+- **Otherwise** use the CLI. If `qlib-sync` is not installed, `uvx --python 3.12 qlib-sync ...` runs it
   without installing; `pip install qlib-sync` installs it. Confirm before installing anything.
 
 ## Update the data

{qlib_sync-0.1.0 → qlib_sync-0.1.1}/src/qlib_sync/__init__.py

@@ -8,6 +8,6 @@ os.environ.setdefault("MLFLOW_DISABLE_AGENT_HINT", "1")
 from .api import health_check_cn, status_cn, update_cn
 from .cn.update import UpdateError, UpdateResult
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 
 __all__ = ["UpdateError", "UpdateResult", "health_check_cn", "status_cn", "update_cn", "__version__"]

{qlib_sync-0.1.0 → qlib_sync-0.1.1}/src/qlib_sync/mcp_server.py

@@ -1,6 +1,6 @@
 """MCP server: let AI assistants check, update, and read the local A-share dataset.
 
-Run with `qlib-sync mcp` (stdio), or without installing: `uvx qlib-sync mcp`.
+Run with `qlib-sync mcp` (stdio), or without installing: `uvx --python 3.12 qlib-sync mcp`.
 """
 
 from __future__ import annotations