fd-daas-mcp 0.1.0__tar.gz

fd_daas_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FindDataOfficial
+
+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.

fd_daas_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: fd-daas-mcp
+Version: 0.1.0
+Summary: Consolidated DAAS MCP server + CLI - hosts the alerts, cron, composite, daas, dashboard, leader, pdf, and research tool groups (~187 tools) behind one stdio FastMCP server and one Click CLI. Both consume fd_daas_mcp/registry.py so the server and CLI surfaces cannot drift.
+Author: FindDataOfficial
+License: MIT
+Project-URL: Homepage, https://github.com/FindDataOfficial/fd-daas-mcp
+Project-URL: Documentation, https://finddataofficial.github.io/fd-daas-mcp/
+Project-URL: Repository, https://github.com/FindDataOfficial/fd-daas-mcp
+Project-URL: Issues, https://github.com/FindDataOfficial/fd-daas-mcp/issues
+Project-URL: Changelog, https://github.com/FindDataOfficial/fd-daas-mcp/blob/main/CHANGELOG.md
+Keywords: mcp,model-context-protocol,fastmcp,data,finance,indicators,dashboards
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Database
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=3.4.2
+Requires-Dist: click>=8.0
+Requires-Dist: pandas>=1.0
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: apscheduler>=3.11.2
+Provides-Extra: crew
+Requires-Dist: crewai; extra == "crew"
+Requires-Dist: litellm; extra == "crew"
+Provides-Extra: akshare
+Requires-Dist: akshare>=1.13; extra == "akshare"
+Provides-Extra: es
+Requires-Dist: elasticsearch>=8.0; extra == "es"
+Provides-Extra: pdf
+Requires-Dist: sentence-transformers; extra == "pdf"
+Requires-Dist: sqlite-vec; extra == "pdf"
+Requires-Dist: pdfplumber; extra == "pdf"
+Requires-Dist: pypdf; extra == "pdf"
+Provides-Extra: position
+Requires-Dist: lxml; extra == "position"
+Requires-Dist: cssselect; extra == "position"
+Requires-Dist: jsonpath-ng; extra == "position"
+Provides-Extra: repl
+Requires-Dist: prompt_toolkit>=3.0; extra == "repl"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: mkdocs>=1.6; extra == "dev"
+Requires-Dist: mkdocs-material>=9.5; extra == "dev"
+Requires-Dist: mkdocs-static-i18n>=1.2; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# fd-daas-mcp
+
+[![PyPI version](https://img.shields.io/pypi/v/fd-daas-mcp.svg)](https://pypi.org/project/fd-daas-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/fd-daas-mcp.svg)](https://pypi.org/project/fd-daas-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Docs](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://finddataofficial.github.io/fd-daas-mcp/)
+
+A single MCP server + CLI for skill-driven data access across financial,
+economic, and statistical sources. Browse thousands of indicators, build entity
+& indicator collections, run research workflows, and share dashboards - all
+behind one stdio server with **181 tools across 8 groups** (187 with the
+optional `pdf` extra).
+
+`fd-daas-mcp` is the engine behind the [DAAS](https://github.com/FindDataOfficial)
+skill-driven data-fetch workflow. Point any MCP client (Claude Code, etc.) at
+it and the tools show up as `<group>_<tool>` calls - e.g. `daas_list_sources`,
+`alerts_create_alert_rule`, `research_create`.
+
+## Install
+
+```bash
+pip install fd-daas-mcp
+```
+
+Optional extras (all lazy-loaded - a missing extra degrades to a per-feature
+error, never a startup crash):
+
+```bash
+pip install "fd-daas-mcp[pdf]"          # local PDF/text vector search (sqlite-vec)
+pip install "fd-daas-mcp[crew]"         # CrewAI router for the leader group
+pip install "fd-daas-mcp[akshare]"      # live A-share OHLCV/fundamentals
+pip install "fd-daas-mcp[position]"     # CSS/xpath/json-path rule extraction
+pip install "fd-daas-mcp[repl]"         # REPL history/autocomplete
+pip install "fd-daas-mcp[dev]"          # pytest + mkdocs for contributors
+```
+
+## 60-second quickstart
+
+```bash
+# 1. Install
+pip install fd-daas-mcp
+
+# 2. Point your MCP client at it. For Claude Code, add to your .mcp.json:
+```
+
+```jsonc
+// .mcp.json
+{
+  "mcpServers": {
+    "fd-daas-mcp": {
+      "command": "fd-daas-mcp-server",
+      "args": []
+    }
+  }
+}
+```
+
+```bash
+# 3. Set a database URL (the schema auto-creates on first startup via
+#    Base.metadata.create_all - no manual init step):
+export DAAS_DATABASE_URL=sqlite:///daas.db
+
+# 4. Or use the CLI directly:
+fd-daas-mcp --help                  # see every group + tool
+fd-daas-mcp daas list_sources       # invoke a tool: <group> <tool> [key=value ...]
+fd-daas-mcp                          # drop into the REPL (needs [repl] extra)
+```
+
+On server startup the schema auto-creates and you'll see the registration
+report:
+
+```
+registry: 181 tools across 8 sources (failed=0, skipped_optional=1)
+```
+
+(181 tools with the default install; 187 with the `pdf` extra installed. The
+`pdf` group is optional and skipped when `sqlite-vec` is absent.)
+
+## Tool groups
+
+| Group       | Surface prefix   | What it does                                                          |
+|-------------|------------------|-----------------------------------------------------------------------|
+| `daas`      | `daas_*`         | Datasource/function/column catalog, entities, indicators, collections, rules, pipelines |
+| `alerts`    | `alerts_*`       | Rule-based alerting over indicator series (Feishu/Discord/Slack/Telegram/DingTalk/WeCom/Twitter) |
+| `cron`      | `cron_*`         | Scheduled task execution + history                                    |
+| `composite` | `composite_*`    | Compose + chain tools across upstream MCPs                            |
+| `dashboard` | `dashboard_*`    | Standalone-HTML dashboard registry + query                            |
+| `leader`    | `leader_*`       | CrewAI DataCrew router, specialist agents, workflows, snapshots       |
+| `pdf`       | `pdf_*`          | Local PDF/text semantic vector search (optional - needs `sqlite-vec`) |
+| `research`  | `research_*`     | Persisted research bundles + generated markdown reports               |
+
+The CLI tree mirrors this: `fd-daas-mcp <group> <tool>`. Both server and CLI
+are generated from the same `registry.build()`, so they cannot drift.
+
+## Skills
+
+The `skills/` directory (in the repo, not the wheel) contains 15 Claude Code
+skills that turn the raw tools into guided workflows - data fetch, research
+orchestration, dashboard building, rule authoring, and more. To use them:
+
+```bash
+git clone https://github.com/FindDataOfficial/fd-daas-mcp.git
+# Then point Claude Code at skills/ in the clone (or symlink into ~/.claude/skills/).
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) and the [docs site](https://finddataofficial.github.io/fd-daas-mcp/) for details.
+
+## Architecture
+
+```
+src/fd_daas_mcp/                 # the installable package
+  server.py                      # FastMCP app - registers every tool as <group>_<tool>
+  cli.py                         # Click CLI - auto-generated from registry.build()
+  registry.py                    # AST-harvests tools from each mcp/<group>/ (per-group sys.modules isolation)
+  selfcheck.py                   # offline invariants (run_invariants())
+  models.py                      # vendored SQLAlchemy schema (Base + ORM for every domain)
+  mcp/                           # tool-group source (shipped as package data)
+    alerts/  cron/  composite/  daas/  dashboard/  leader/  pdf/  research/
+```
+
+The registry loads each group's `server.py` and harvests `@app.tool`-decorated
+functions (inline groups) or the `*_tools.py` modules they import (non-inline
+groups), with per-group `sys.modules` isolation so leaf modules like
+`database.py` don't collide across groups. The `cron` group is loaded with
+`suppress=True` to neutralize APScheduler's import-time thread while keeping
+its idempotent DDL.
+
+## Development
+
+```bash
+git clone https://github.com/FindDataOfficial/fd-daas-mcp.git
+cd fd-daas-mcp
+uv sync --extra dev               # editable install + dev deps (pytest, mkdocs, twine)
+uv run pytest                     # offline test suite
+uv run python -m fd_daas_mcp.selfcheck
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
+
+## License
+
+[MIT](LICENSE) - © FindDataOfficial.

fd_daas_mcp-0.1.0/README.md

@@ -0,0 +1,142 @@
+# fd-daas-mcp
+
+[![PyPI version](https://img.shields.io/pypi/v/fd-daas-mcp.svg)](https://pypi.org/project/fd-daas-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/fd-daas-mcp.svg)](https://pypi.org/project/fd-daas-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Docs](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://finddataofficial.github.io/fd-daas-mcp/)
+
+A single MCP server + CLI for skill-driven data access across financial,
+economic, and statistical sources. Browse thousands of indicators, build entity
+& indicator collections, run research workflows, and share dashboards - all
+behind one stdio server with **181 tools across 8 groups** (187 with the
+optional `pdf` extra).
+
+`fd-daas-mcp` is the engine behind the [DAAS](https://github.com/FindDataOfficial)
+skill-driven data-fetch workflow. Point any MCP client (Claude Code, etc.) at
+it and the tools show up as `<group>_<tool>` calls - e.g. `daas_list_sources`,
+`alerts_create_alert_rule`, `research_create`.
+
+## Install
+
+```bash
+pip install fd-daas-mcp
+```
+
+Optional extras (all lazy-loaded - a missing extra degrades to a per-feature
+error, never a startup crash):
+
+```bash
+pip install "fd-daas-mcp[pdf]"          # local PDF/text vector search (sqlite-vec)
+pip install "fd-daas-mcp[crew]"         # CrewAI router for the leader group
+pip install "fd-daas-mcp[akshare]"      # live A-share OHLCV/fundamentals
+pip install "fd-daas-mcp[position]"     # CSS/xpath/json-path rule extraction
+pip install "fd-daas-mcp[repl]"         # REPL history/autocomplete
+pip install "fd-daas-mcp[dev]"          # pytest + mkdocs for contributors
+```
+
+## 60-second quickstart
+
+```bash
+# 1. Install
+pip install fd-daas-mcp
+
+# 2. Point your MCP client at it. For Claude Code, add to your .mcp.json:
+```
+
+```jsonc
+// .mcp.json
+{
+  "mcpServers": {
+    "fd-daas-mcp": {
+      "command": "fd-daas-mcp-server",
+      "args": []
+    }
+  }
+}
+```
+
+```bash
+# 3. Set a database URL (the schema auto-creates on first startup via
+#    Base.metadata.create_all - no manual init step):
+export DAAS_DATABASE_URL=sqlite:///daas.db
+
+# 4. Or use the CLI directly:
+fd-daas-mcp --help                  # see every group + tool
+fd-daas-mcp daas list_sources       # invoke a tool: <group> <tool> [key=value ...]
+fd-daas-mcp                          # drop into the REPL (needs [repl] extra)
+```
+
+On server startup the schema auto-creates and you'll see the registration
+report:
+
+```
+registry: 181 tools across 8 sources (failed=0, skipped_optional=1)
+```
+
+(181 tools with the default install; 187 with the `pdf` extra installed. The
+`pdf` group is optional and skipped when `sqlite-vec` is absent.)
+
+## Tool groups
+
+| Group       | Surface prefix   | What it does                                                          |
+|-------------|------------------|-----------------------------------------------------------------------|
+| `daas`      | `daas_*`         | Datasource/function/column catalog, entities, indicators, collections, rules, pipelines |
+| `alerts`    | `alerts_*`       | Rule-based alerting over indicator series (Feishu/Discord/Slack/Telegram/DingTalk/WeCom/Twitter) |
+| `cron`      | `cron_*`         | Scheduled task execution + history                                    |
+| `composite` | `composite_*`    | Compose + chain tools across upstream MCPs                            |
+| `dashboard` | `dashboard_*`    | Standalone-HTML dashboard registry + query                            |
+| `leader`    | `leader_*`       | CrewAI DataCrew router, specialist agents, workflows, snapshots       |
+| `pdf`       | `pdf_*`          | Local PDF/text semantic vector search (optional - needs `sqlite-vec`) |
+| `research`  | `research_*`     | Persisted research bundles + generated markdown reports               |
+
+The CLI tree mirrors this: `fd-daas-mcp <group> <tool>`. Both server and CLI
+are generated from the same `registry.build()`, so they cannot drift.
+
+## Skills
+
+The `skills/` directory (in the repo, not the wheel) contains 15 Claude Code
+skills that turn the raw tools into guided workflows - data fetch, research
+orchestration, dashboard building, rule authoring, and more. To use them:
+
+```bash
+git clone https://github.com/FindDataOfficial/fd-daas-mcp.git
+# Then point Claude Code at skills/ in the clone (or symlink into ~/.claude/skills/).
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) and the [docs site](https://finddataofficial.github.io/fd-daas-mcp/) for details.
+
+## Architecture
+
+```
+src/fd_daas_mcp/                 # the installable package
+  server.py                      # FastMCP app - registers every tool as <group>_<tool>
+  cli.py                         # Click CLI - auto-generated from registry.build()
+  registry.py                    # AST-harvests tools from each mcp/<group>/ (per-group sys.modules isolation)
+  selfcheck.py                   # offline invariants (run_invariants())
+  models.py                      # vendored SQLAlchemy schema (Base + ORM for every domain)
+  mcp/                           # tool-group source (shipped as package data)
+    alerts/  cron/  composite/  daas/  dashboard/  leader/  pdf/  research/
+```
+
+The registry loads each group's `server.py` and harvests `@app.tool`-decorated
+functions (inline groups) or the `*_tools.py` modules they import (non-inline
+groups), with per-group `sys.modules` isolation so leaf modules like
+`database.py` don't collide across groups. The `cron` group is loaded with
+`suppress=True` to neutralize APScheduler's import-time thread while keeping
+its idempotent DDL.
+
+## Development
+
+```bash
+git clone https://github.com/FindDataOfficial/fd-daas-mcp.git
+cd fd-daas-mcp
+uv sync --extra dev               # editable install + dev deps (pytest, mkdocs, twine)
+uv run pytest                     # offline test suite
+uv run python -m fd_daas_mcp.selfcheck
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
+
+## License
+
+[MIT](LICENSE) - © FindDataOfficial.

fd_daas_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,94 @@
+[project]
+name = "fd-daas-mcp"
+version = "0.1.0"
+description = "Consolidated DAAS MCP server + CLI - hosts the alerts, cron, composite, daas, dashboard, leader, pdf, and research tool groups (~187 tools) behind one stdio FastMCP server and one Click CLI. Both consume fd_daas_mcp/registry.py so the server and CLI surfaces cannot drift."
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "MIT" }
+authors = [{ name = "FindDataOfficial" }]
+keywords = ["mcp", "model-context-protocol", "fastmcp", "data", "finance", "indicators", "dashboards"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Database",
+    "Topic :: Office/Business :: Financial",
+    "Typing :: Typed",
+]
+dependencies = [
+    "fastmcp>=3.4.2",
+    "click>=8.0",
+    "pandas>=1.0",
+    "sqlalchemy>=2.0",
+    "python-dotenv>=1.0",
+    "apscheduler>=3.11.2",
+]
+
+[project.urls]
+Homepage = "https://github.com/FindDataOfficial/fd-daas-mcp"
+Documentation = "https://finddataofficial.github.io/fd-daas-mcp/"
+Repository = "https://github.com/FindDataOfficial/fd-daas-mcp"
+Issues = "https://github.com/FindDataOfficial/fd-daas-mcp/issues"
+Changelog = "https://github.com/FindDataOfficial/fd-daas-mcp/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+# CrewAI powers leader's DataCrew router (ask_data_crew) + specialist agents.
+# Falls back to a deterministic direct router when absent.
+crew = ["crewai", "litellm"]
+# akshare is imported lazily by daas source modules; install for live A-share fetches.
+akshare = ["akshare>=1.13"]
+# elasticsearch powers cnreport ES store/search tools.
+es = ["elasticsearch>=8.0"]
+# Local PDF/text vector search: sentence-transformers (embeddings) + sqlite-vec
+# (vec0 ANN index) + pdfplumber/pypdf (text extraction). Loaded as an optional
+# `pdf` tool group gated on `sqlite_vec` (see registry.py). No API key, no egress.
+pdf = ["sentence-transformers", "sqlite-vec", "pdfplumber", "pypdf"]
+# Position rules: CSS/xpath (lxml+cssselect) + json-path (jsonpath-ng) extraction.
+# regex needs no extra dep. Lazy-imported by rule_engine._eval_position, so a
+# missing install degrades to a per-rule error, never a server-startup crash.
+position = ["lxml", "cssselect", "jsonpath-ng"]
+# REPL history/autocomplete.
+repl = ["prompt_toolkit>=3.0"]
+dev = [
+    "pytest>=8.0",
+    "mkdocs>=1.6",
+    "mkdocs-material>=9.5",
+    "mkdocs-static-i18n>=1.2",
+    "twine>=5.0",
+]
+
+[project.scripts]
+fd-daas-mcp = "fd_daas_mcp.cli:cli"
+fd-daas-mcp-server = "fd_daas_mcp.server:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["fd_daas_mcp*"]
+
+[tool.setuptools.package-data]
+fd_daas_mcp = [
+    "mcp/**/*.py",
+    "mcp/**/*.md",
+    "mcp/**/*.json",
+    "mcp/**/*.yaml",
+    "mcp/**/*.yml",
+    "mcp/**/*.txt",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+# The .venv leaks micromamba site-packages whose logfire pytest plugin crashes
+# on import (opentelemetry._tail_sampling). `-p no:X` is a no-op when the plugin
+# isn't registered, so this is safe in a clean venv too.
+addopts = "-p no:logfire -p no:pytest_logfire"
+
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"

fd_daas_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fd_daas_mcp-0.1.0/src/fd_daas_mcp/__init__.py

@@ -0,0 +1,13 @@
+"""fd-daas-mcp - the single consolidated MCP server for the DAAS platform.
+
+This is the only MCP in the project. Tool logic is hosted in-package at
+``fd-daas-mcp/<group>-mcp/`` (moved, not rewritten, from the former ``mcp/``
+source dirs). The :mod:`registry` imports each group's tool functions with
+per-group ``sys.modules`` isolation and re-exposes them under a collision-free
+``<group>_<tool>`` namespace on one FastMCP server (and one Click CLI).
+
+Groups (core always-on unless the extra is absent): alerts, cron, composite,
+daas, dashboard, leader, pdf, cnreport, massive, scrapling, firecrawl.
+"""
+
+__version__ = "0.1.0"

fd_daas_mcp-0.1.0/src/fd_daas_mcp/cli.py

@@ -0,0 +1,151 @@
+"""Click CLI for fd-daas-mcp - auto-generated from the same registry as the server.
+
+Usage:
+  fd-daas-mcp <group> <tool> [key=value ...] [--json]
+  fd-daas-mcp                       # REPL mode (needs [repl] extra for history)
+  fd-daas-mcp --help                # authoritative live surface (no drift)
+"""
+from __future__ import annotations
+
+import asyncio
+import inspect
+import json
+import sys
+from pathlib import Path
+from typing import Any
+
+import click
+
+from fd_daas_mcp import registry
+
+
+def _parse_value(v: str) -> Any:
+    try:
+        return json.loads(v)
+    except (json.JSONDecodeError, ValueError):
+        return v
+
+
+def _print(result: Any, as_json: bool) -> None:
+    if isinstance(result, (dict, list)) or as_json:
+        try:
+            click.echo(json.dumps(result, default=str, ensure_ascii=False, indent=2))
+            return
+        except (TypeError, ValueError):
+            pass
+    click.echo(str(result))
+
+
+def _make_command(name: str, func: Any) -> click.Command:
+    sig = inspect.signature(func)
+    params = list(sig.parameters.values())
+    help_text = ""
+    if func.__doc__:
+        help_text = func.__doc__.strip().split("\n\n", 1)[0][:200]
+
+    @click.command(name=name, help=help_text or name)
+    @click.argument("kv", nargs=-1)
+    @click.option("--json", "as_json", is_flag=True, help="Print raw JSON output")
+    def _cmd(kv, as_json):
+        kwargs: dict[str, Any] = {}
+        for pair in kv:
+            if "=" not in pair:
+                click.echo(f"error: argument {pair!r} is not key=value", err=True)
+                sys.exit(2)
+            k, v = pair.split("=", 1)
+            kwargs[k] = _parse_value(v)
+        for p in params:
+            if p.name not in kwargs and p.default is inspect.Parameter.empty:
+                click.echo(f"error: missing required parameter {p.name}", err=True)
+                sys.exit(2)
+        try:
+            if inspect.iscoroutinefunction(func):
+                result = asyncio.run(func(**kwargs))
+            else:
+                result = func(**kwargs)
+        except SystemExit:
+            raise
+        except Exception as e:  # noqa: BLE001
+            click.echo(f"error: {type(e).__name__}: {e}", err=True)
+            sys.exit(1)
+        _print(result, as_json)
+
+    return _cmd
+
+
+@click.group(invoke_without_command=True)
+@click.pass_context
+def cli(ctx: click.Context) -> None:
+    """fd-daas-mcp - the consolidated DAAS MCP CLI. Run with no subcommand for REPL."""
+    if ctx.invoked_subcommand is None:
+        _repl()
+
+
+def _repl() -> None:
+    session = None
+    try:
+        from prompt_toolkit import PromptSession
+        from prompt_toolkit.history import FileHistory
+
+        hist = Path.home() / ".cache" / "fd-daas-mcp" / "history"
+        hist.parent.mkdir(parents=True, exist_ok=True)
+        session = PromptSession(history=FileHistory(str(hist)))
+    except ImportError:
+        pass
+    click.echo("fd-daas-mcp REPL. Ctrl-D to exit. `--help` lists groups/tools.")
+    while True:
+        try:
+            line = (session.prompt("fd-daas-mcp> ") if session else input("fd-daas-mcp> ")).strip()
+        except (EOFError, KeyboardInterrupt):
+            click.echo("")
+            break
+        if not line:
+            continue
+        try:
+            cli.main(line.split(), standalone_mode=False)
+        except click.exceptions.UsageError as e:
+            click.echo(str(e), err=True)
+        except SystemExit:
+            pass
+
+
+for _group, _name, _func in registry.build():
+    if _group not in cli.commands:
+        _grp = click.Group(name=_group, help=f"{_group} group")
+        cli.add_command(_grp)
+    cli.commands[_group].add_command(_make_command(_name, _func))
+
+
+def _pdf_branch(argv: list[str]) -> int:
+    """In-process cron branches --pdf-ingest / --pdf-search for the optional
+    pdf group (mirror daas-mcp/server.py's --run-rule). Reachable as:
+    ``python -m fd_daas_mcp.cli --pdf-ingest <path|url>`` /
+    ``--pdf-search "<query>"``. Returns a structured error when the [pdf]
+    extra is absent."""
+    _pdf_dir = Path(__file__).resolve().parents[2] / "pdf-mcp"
+    if str(_pdf_dir) not in sys.path:
+        sys.path.insert(0, str(_pdf_dir))
+    try:
+        from pdf_tools import cli_ingest, cli_search  # type: ignore
+    except Exception as e:  # noqa: BLE001
+        click.echo(json.dumps({"error": f"pdf extra not installed: {e}. uv sync --extra pdf"}))
+        return 1
+    if "--pdf-ingest" in argv:
+        i = argv.index("--pdf-ingest")
+        if i + 1 >= len(argv):
+            click.echo(json.dumps({"error": "--pdf-ingest requires a <path|url> argument"}))
+            return 2
+        return cli_ingest(argv[i + 1])
+    if "--pdf-search" in argv:
+        i = argv.index("--pdf-search")
+        if i + 1 >= len(argv):
+            click.echo(json.dumps({"error": "--pdf-search requires a <query> argument"}))
+            return 2
+        return cli_search(argv[i + 1])
+    return 0
+
+
+if __name__ == "__main__":
+    if "--pdf-ingest" in sys.argv or "--pdf-search" in sys.argv:
+        sys.exit(_pdf_branch(sys.argv[1:]))
+    cli()