futu-opend-mcp 0.1.1__tar.gz

futu_opend_mcp-0.1.1/.env.example

@@ -0,0 +1,13 @@
+# Futu OpenD gateway (must already be running + logged in)
+FUTU_OPEND_HOST=127.0.0.1
+FUTU_OPEND_PORT=11111
+
+# RSA private key (shared with OpenD's FutuOpenD.xml), PKCS#1 1024-bit PEM.
+# Provide ONE of the two forms:
+FUTU_OPEND_RSA_KEY=
+FUTU_OPEND_RSA_KEY_FILE=
+
+# Enable proto encryption. Set false ONLY for a local 127.0.0.1 OpenD.
+FUTU_OPEND_ENCRYPT=true
+
+FUTU_OPEND_LOG_LEVEL=INFO

futu_opend_mcp-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,14 @@
+name: ci
+on:
+  push: { branches: [main] }
+  pull_request:
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - run: pip install -e ".[dev]"
+      - run: ruff check .
+      - run: pytest -q -m "not integration"

futu_opend_mcp-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,15 @@
+name: publish
+on:
+  push:
+    tags: ["v*"]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions: { id-token: write }
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - run: pip install build && python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        # Configure trusted publishing at https://pypi.org/manage/project/futu-opend-mcp/publishing/

futu_opend_mcp-0.1.1/.gitignore

@@ -0,0 +1,13 @@
+.env
+*.egg-info/
+__pycache__/
+.venv/
+dist/
+build/
+.pytest_cache/
+*.pyc
+*.pyo
+.env.local
+*.log
+.mypy_cache/
+.ruff_cache/

futu_opend_mcp-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 eli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

futu_opend_mcp-0.1.1/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: futu-opend-mcp
+Version: 0.1.1
+Summary: MCP server exposing Futu OpenD read-only investment-research quote APIs.
+Author: eli
+License-Expression: MIT
+License-File: LICENSE
+Keywords: finance,futu,mcp,opend,stock
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: futu-api>=10.5.6508
+Requires-Dist: mcp>=1.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# futu-opend-mcp
+
+An MCP server that exposes Futu OpenD's **read-only investment-research** quote APIs
+(stock/option/warrant/futures prices, financials, news/announcements, shareholders,
+institutions, macro) as MCP tools. It borrows your already-running, logged-in Futu
+OpenD gateway - no separate auth. No trading, no subscriptions.
+
+It wraps the [official Futu skill pack](https://openapi.futunn.com/skills/opend-skills.zip)
+unmodified, so it stays in sync with Futu's own field-parsing logic.
+
+## Install & run
+
+### Claude Code / Claude Desktop (stdio)
+
+```
+claude mcp add futu-opend-mcp -- uvx futu-opend-mcp
+```
+
+Or from git before a PyPI release:
+```
+claude mcp add futu-opend-mcp -- uvx --from git+https://github.com/ER-EPR/futu-opend-mcp futu-opend-mcp
+```
+
+### Open WebUI via mcpo (HTTP)
+
+```
+uvx mcpo --port 8000 -- futu-opend-mcp
+# OpenAPI at http://localhost:8000, docs at /docs
+```
+
+### MCP JSON config
+
+Add to `~/.claude/settings.json`, `.mcp.json`, or Claude Desktop config:
+
+**Remote OpenD (with encryption):**
+```json
+{
+  "mcpServers": {
+    "futu-opend": {
+      "command": "uvx",
+      "args": ["futu-opend-mcp"],
+      "env": {
+        "FUTU_OPEND_HOST": "your-opend-host",
+        "FUTU_OPEND_PORT": "11111",
+        "FUTU_OPEND_ENCRYPT": "true",
+        "FUTU_OPEND_RSA_KEY": "-----BEGIN RSA PRIVATE KEY-----\\nMIIC...\\n-----END RSA PRIVATE KEY-----"
+      }
+    }
+  }
+}
+```
+
+**Local OpenD (no encryption):**
+```json
+{
+  "mcpServers": {
+    "futu-opend": {
+      "command": "uvx",
+      "args": ["futu-opend-mcp"],
+      "env": {
+        "FUTU_OPEND_ENCRYPT": "false"
+      }
+    }
+  }
+}
+```
+
+Extract the RSA key for the env var:
+```bash
+docker exec futu-opend cat /rsa/rsa_private_pkcs1.pem | awk '{printf "%s\\n", $0}'
+```
+
+## Configuration (env vars)
+
+| Var | Default | Purpose |
+|---|---|---|
+| `FUTU_OPEND_HOST` | `127.0.0.1` | OpenD host |
+| `FUTU_OPEND_PORT` | `11111` | OpenD port |
+| `FUTU_OPEND_RSA_KEY` | - | inline PEM of the shared RSA private key |
+| `FUTU_OPEND_RSA_KEY_FILE` | - | path to the PEM file (alternative to above) |
+| `FUTU_OPEND_ENCRYPT` | `true` | proto encryption; `false` for local 127.0.0.1 OpenD |
+| `FUTU_OPEND_LOG_LEVEL` | `INFO` | logging level |
+
+OpenD and the SDK share one RSA private key (PKCS#1 1024-bit). Get it from a dockerized
+OpenD with: `docker compose logs opend | grep -A20 'NEW RSA PRIVATE KEY'`.
+
+## Tools
+
+~50 read-only tools across: price/quote, search, screening, financials, research/valuation,
+corporate actions, shareholders, profile, capital flow, short interest, options, option
+underlying IV/HV, warrants/futures, plates, industrial chains, institutions, macro,
+dividends, IPO, and diagnostics. See `docs/superpowers/specs/2026-07-10-futu-opend-mcp-design.md`.
+
+## Development
+
+```
+pip install -e ".[dev]"
+pytest -q -m "not integration"   # unit tests (no OpenD needed)
+ruff check .
+```
+
+Live-OpenD integration tests are marked `integration` and skip themselves when OpenD is
+unreachable. Re-vendor the official skill pack with `./scripts/sync_skill.sh`.
+
+## Attribution
+
+Wraps the official Futu `futuapi` skill pack (vendored under
+`src/futu_opend_mcp/_skill/futuapi/`, unmodified). Legal terms in that folder apply.
+
+## License
+
+MIT.

futu_opend_mcp-0.1.1/README.md

@@ -0,0 +1,112 @@
+# futu-opend-mcp
+
+An MCP server that exposes Futu OpenD's **read-only investment-research** quote APIs
+(stock/option/warrant/futures prices, financials, news/announcements, shareholders,
+institutions, macro) as MCP tools. It borrows your already-running, logged-in Futu
+OpenD gateway - no separate auth. No trading, no subscriptions.
+
+It wraps the [official Futu skill pack](https://openapi.futunn.com/skills/opend-skills.zip)
+unmodified, so it stays in sync with Futu's own field-parsing logic.
+
+## Install & run
+
+### Claude Code / Claude Desktop (stdio)
+
+```
+claude mcp add futu-opend-mcp -- uvx futu-opend-mcp
+```
+
+Or from git before a PyPI release:
+```
+claude mcp add futu-opend-mcp -- uvx --from git+https://github.com/ER-EPR/futu-opend-mcp futu-opend-mcp
+```
+
+### Open WebUI via mcpo (HTTP)
+
+```
+uvx mcpo --port 8000 -- futu-opend-mcp
+# OpenAPI at http://localhost:8000, docs at /docs
+```
+
+### MCP JSON config
+
+Add to `~/.claude/settings.json`, `.mcp.json`, or Claude Desktop config:
+
+**Remote OpenD (with encryption):**
+```json
+{
+  "mcpServers": {
+    "futu-opend": {
+      "command": "uvx",
+      "args": ["futu-opend-mcp"],
+      "env": {
+        "FUTU_OPEND_HOST": "your-opend-host",
+        "FUTU_OPEND_PORT": "11111",
+        "FUTU_OPEND_ENCRYPT": "true",
+        "FUTU_OPEND_RSA_KEY": "-----BEGIN RSA PRIVATE KEY-----\\nMIIC...\\n-----END RSA PRIVATE KEY-----"
+      }
+    }
+  }
+}
+```
+
+**Local OpenD (no encryption):**
+```json
+{
+  "mcpServers": {
+    "futu-opend": {
+      "command": "uvx",
+      "args": ["futu-opend-mcp"],
+      "env": {
+        "FUTU_OPEND_ENCRYPT": "false"
+      }
+    }
+  }
+}
+```
+
+Extract the RSA key for the env var:
+```bash
+docker exec futu-opend cat /rsa/rsa_private_pkcs1.pem | awk '{printf "%s\\n", $0}'
+```
+
+## Configuration (env vars)
+
+| Var | Default | Purpose |
+|---|---|---|
+| `FUTU_OPEND_HOST` | `127.0.0.1` | OpenD host |
+| `FUTU_OPEND_PORT` | `11111` | OpenD port |
+| `FUTU_OPEND_RSA_KEY` | - | inline PEM of the shared RSA private key |
+| `FUTU_OPEND_RSA_KEY_FILE` | - | path to the PEM file (alternative to above) |
+| `FUTU_OPEND_ENCRYPT` | `true` | proto encryption; `false` for local 127.0.0.1 OpenD |
+| `FUTU_OPEND_LOG_LEVEL` | `INFO` | logging level |
+
+OpenD and the SDK share one RSA private key (PKCS#1 1024-bit). Get it from a dockerized
+OpenD with: `docker compose logs opend | grep -A20 'NEW RSA PRIVATE KEY'`.
+
+## Tools
+
+~50 read-only tools across: price/quote, search, screening, financials, research/valuation,
+corporate actions, shareholders, profile, capital flow, short interest, options, option
+underlying IV/HV, warrants/futures, plates, industrial chains, institutions, macro,
+dividends, IPO, and diagnostics. See `docs/superpowers/specs/2026-07-10-futu-opend-mcp-design.md`.
+
+## Development
+
+```
+pip install -e ".[dev]"
+pytest -q -m "not integration"   # unit tests (no OpenD needed)
+ruff check .
+```
+
+Live-OpenD integration tests are marked `integration` and skip themselves when OpenD is
+unreachable. Re-vendor the official skill pack with `./scripts/sync_skill.sh`.
+
+## Attribution
+
+Wraps the official Futu `futuapi` skill pack (vendored under
+`src/futu_opend_mcp/_skill/futuapi/`, unmodified). Legal terms in that folder apply.
+
+## License
+
+MIT.