datasinking 0.2.11__tar.gz → 0.2.13__tar.gz

{datasinking-0.2.11 → datasinking-0.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datasinking
-Version: 0.2.11
+Version: 0.2.13
 Summary: Python client for DataSinking — full-text Asian financial reports (China, Korea, Japan, Taiwan) as Markdown.
 Author: DataSinking
 License: MIT
@@ -41,20 +41,21 @@ with YAML frontmatter, preserved headings, paragraphs and tables.
 
 ## MCP server
 
-Ship DataSinking to any AI agent (Claude / Cursor / Codex / Windsurf) as an
+Ship DataSinking to any AI agent (Claude / Cursor / Codex / Devin Desktop) as an
 [MCP](https://modelcontextprotocol.io) server — 6 tools: list exchanges, list stocks,
 list reports, fetch a report, list sections, fetch one section (token-friendly for RAG).
 
 ### Hosted — nothing to install
 
-Point any MCP client at our endpoint and you're done. No package, no Python, no local server:
+One URL, no package, no Python, no local server. Most clients take this shape:
 
 ```json
 {
   "mcpServers": {
     "datasinking": {
       "type": "http",
-      "url": "https://api.datasink.ing/mcp?apikey=YOUR_KEY"
+      "url": "https://api.datasink.ing/mcp",
+      "headers": { "Authorization": "Bearer YOUR_KEY" }
     }
   }
 }
@@ -67,9 +68,12 @@ claude mcp add --transport http datasinking https://api.datasink.ing/mcp \
   --header "Authorization: Bearer YOUR_KEY"
 ```
 
-Your key rides inside the URL, so treat that config as a secret. Clients that support custom
-headers can send `Authorization: Bearer YOUR_KEY` instead — Claude Code redacts headers in its
-output but can't redact a URL.
+A client that can't set a header can put the key in the URL instead —
+`https://api.datasink.ing/mcp?apikey=YOUR_KEY` — but only do that when you must: a key in a URL
+ends up in logs and screen shares, and no client can redact it.
+
+Two clients don't fit the shape above: Codex's config is TOML, and Devin Desktop's remote field is
+`serverUrl`, not `url`. Per-client files: [`docs/mcp/`](docs/mcp/).
 
 ### Local — run it yourself
 
@@ -104,8 +108,9 @@ kept in lockstep by [`check_mcp_parity.py`](check_mcp_parity.py).
 
 Full per-client setup: [`mcp-server.md`](mcp-server.md) (overview) ·
 [`docs/mcp/`](docs/mcp/) (one guide per client).
-Hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, no session id, and every
-client needs a restart after a config change. That trips up most first connections.
+
+The hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, and no session id is
+issued. Most clients read MCP config at launch, so restart one after changing its config.
 
 ![DataSinking MCP in Claude](docs/images/mcp-demo.png)
 
@@ -119,8 +124,8 @@ datasinking/
 ├── research/     # Research notes / blog posts (reproducing paper-style presentation)
 ├── datasinking/  # Python client + MCP server — pip install "datasinking[mcp]"
 ├── npm/          # The same MCP server on npm — npx -y datasinking-mcp (Node 18+)
-├── docs/mcp/     # Per-client MCP setup: Claude Code, Claude Desktop, Cursor, Codex, WorkBuddy
-├── mcp-server.md # MCP server overview — the two config shapes, tools, endpoint limits
+├── docs/mcp/     # Per-client MCP setup — Claude Code, Desktop, Cursor, Codex, WorkBuddy, Devin…
+├── mcp-server.md # MCP server overview — endpoint, per-client table, tools, troubleshooting
 ├── llm-examples.md  # Ask an LLM — no code needed (8 end-to-end examples)
 ├── api-examples.md  # 7 examples × 3 interfaces (curl / Python / LLM)
 └── README.md
@@ -135,9 +140,10 @@ errors that client actually produces:
 | Claude Desktop | [`docs/mcp/claude-desktop.md`](docs/mcp/claude-desktop.md) |
 | OpenAI Codex CLI | [`docs/mcp/codex.md`](docs/mcp/codex.md) |
 | WorkBuddy / CodeBuddy | [`docs/mcp/workbuddy.md`](docs/mcp/workbuddy.md) |
+| Doubao Work / 豆包工作 | [`docs/mcp/doubao.md`](docs/mcp/doubao.md) |
 | Cursor | [`docs/mcp/cursor.md`](docs/mcp/cursor.md) |
-| DeepSeek | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
-| Windsurf | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.md) |
+| DeepSeek Harness (`dsh`) | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
+| Devin Desktop | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.md) |
 
 ## Quick start
 

{datasinking-0.2.11 → datasinking-0.2.13}/README.md

@@ -18,20 +18,21 @@ with YAML frontmatter, preserved headings, paragraphs and tables.
 
 ## MCP server
 
-Ship DataSinking to any AI agent (Claude / Cursor / Codex / Windsurf) as an
+Ship DataSinking to any AI agent (Claude / Cursor / Codex / Devin Desktop) as an
 [MCP](https://modelcontextprotocol.io) server — 6 tools: list exchanges, list stocks,
 list reports, fetch a report, list sections, fetch one section (token-friendly for RAG).
 
 ### Hosted — nothing to install
 
-Point any MCP client at our endpoint and you're done. No package, no Python, no local server:
+One URL, no package, no Python, no local server. Most clients take this shape:
 
 ```json
 {
   "mcpServers": {
     "datasinking": {
       "type": "http",
-      "url": "https://api.datasink.ing/mcp?apikey=YOUR_KEY"
+      "url": "https://api.datasink.ing/mcp",
+      "headers": { "Authorization": "Bearer YOUR_KEY" }
     }
   }
 }
@@ -44,9 +45,12 @@ claude mcp add --transport http datasinking https://api.datasink.ing/mcp \
   --header "Authorization: Bearer YOUR_KEY"
 ```
 
-Your key rides inside the URL, so treat that config as a secret. Clients that support custom
-headers can send `Authorization: Bearer YOUR_KEY` instead — Claude Code redacts headers in its
-output but can't redact a URL.
+A client that can't set a header can put the key in the URL instead —
+`https://api.datasink.ing/mcp?apikey=YOUR_KEY` — but only do that when you must: a key in a URL
+ends up in logs and screen shares, and no client can redact it.
+
+Two clients don't fit the shape above: Codex's config is TOML, and Devin Desktop's remote field is
+`serverUrl`, not `url`. Per-client files: [`docs/mcp/`](docs/mcp/).
 
 ### Local — run it yourself
 
@@ -81,8 +85,9 @@ kept in lockstep by [`check_mcp_parity.py`](check_mcp_parity.py).
 
 Full per-client setup: [`mcp-server.md`](mcp-server.md) (overview) ·
 [`docs/mcp/`](docs/mcp/) (one guide per client).
-Hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, no session id, and every
-client needs a restart after a config change. That trips up most first connections.
+
+The hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, and no session id is
+issued. Most clients read MCP config at launch, so restart one after changing its config.
 
 ![DataSinking MCP in Claude](docs/images/mcp-demo.png)
 
@@ -96,8 +101,8 @@ datasinking/
 ├── research/     # Research notes / blog posts (reproducing paper-style presentation)
 ├── datasinking/  # Python client + MCP server — pip install "datasinking[mcp]"
 ├── npm/          # The same MCP server on npm — npx -y datasinking-mcp (Node 18+)
-├── docs/mcp/     # Per-client MCP setup: Claude Code, Claude Desktop, Cursor, Codex, WorkBuddy
-├── mcp-server.md # MCP server overview — the two config shapes, tools, endpoint limits
+├── docs/mcp/     # Per-client MCP setup — Claude Code, Desktop, Cursor, Codex, WorkBuddy, Devin…
+├── mcp-server.md # MCP server overview — endpoint, per-client table, tools, troubleshooting
 ├── llm-examples.md  # Ask an LLM — no code needed (8 end-to-end examples)
 ├── api-examples.md  # 7 examples × 3 interfaces (curl / Python / LLM)
 └── README.md
@@ -112,9 +117,10 @@ errors that client actually produces:
 | Claude Desktop | [`docs/mcp/claude-desktop.md`](docs/mcp/claude-desktop.md) |
 | OpenAI Codex CLI | [`docs/mcp/codex.md`](docs/mcp/codex.md) |
 | WorkBuddy / CodeBuddy | [`docs/mcp/workbuddy.md`](docs/mcp/workbuddy.md) |
+| Doubao Work / 豆包工作 | [`docs/mcp/doubao.md`](docs/mcp/doubao.md) |
 | Cursor | [`docs/mcp/cursor.md`](docs/mcp/cursor.md) |
-| DeepSeek | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
-| Windsurf | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.md) |
+| DeepSeek Harness (`dsh`) | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
+| Devin Desktop | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.md) |
 
 ## Quick start
 

{datasinking-0.2.11 → datasinking-0.2.13}/datasinking/_version.py

@@ -1,11 +1,11 @@
-# -*- coding: utf-8 -*-
-"""版本号的**唯一来源**。
-
-pyproject.toml 用 `dynamic = ["version"]` 从这里读，`client.py` 的 User-Agent 也读它。
-
-为什么单独抽一个文件：之前 pyproject.toml 和 `__init__.py` 各写各的版本号，
-结果 `__version__` 长期停在 0.1.0 没跟上（发 0.2.4 时才发现，User-Agent 里也一直
-写着旧版本）。现在只有这一处需要改。
-"""
-
-__version__ = "0.2.11"
+# -*- coding: utf-8 -*-
+"""版本号的**唯一来源**。
+
+pyproject.toml 用 `dynamic = ["version"]` 从这里读，`client.py` 的 User-Agent 也读它。
+
+为什么单独抽一个文件：之前 pyproject.toml 和 `__init__.py` 各写各的版本号，
+结果 `__version__` 长期停在 0.1.0 没跟上（发 0.2.4 时才发现，User-Agent 里也一直
+写着旧版本）。现在只有这一处需要改。
+"""
+
+__version__ = "0.2.13"

{datasinking-0.2.11 → datasinking-0.2.13}/datasinking/mcp_server.py

@@ -3,7 +3,7 @@
 
 Expose the DataSinking API — full-text financial reports across Asia
 (China, Korea, Japan, Taiwan) as clean Markdown — to AI agents (Claude, Cursor,
-Codex, DeepSeek, Windsurf, …).
+Codex, DeepSeek, Devin Desktop, …).
 
 Install the MCP extra::
 
@@ -33,6 +33,25 @@ try:
 except ImportError:  # pragma: no cover
     from mcp.server.mcpserver import MCPServer as FastMCP  # mcp v2
 
+# ⚠️ **工具里必须抛 ToolError，不能抛 RuntimeError。**
+#
+# mcp v2（实测 2.2.0）对两者的处理完全不同：
+#     抛 RuntimeError  → 客户端收到 isError:true，但文本是**通用句**
+#                         「Error executing tool <名字>」，**消息内容被剥掉**，只进 stderr
+#     抛 ToolError     → 客户端收到 isError:true，文本带上你的原话
+#                         「Error executing tool <名字>: <你的消息>」
+#
+# 这不是细节：get_section 的描述让模型「用真实标题重试」，标题列表就在消息里；
+# 缺 API key 的提示也只在这里。用 RuntimeError 的话，模型看到的是一个**没有任何线索**的
+# 失败 —— 2026-09-22 用真 key 走 uvx 发布版实测确认（`Error executing tool get_section`，32 字符）。
+try:
+    from mcp.server.fastmcp.exceptions import ToolError  # mcp v1
+except ImportError:  # pragma: no cover
+    try:
+        from mcp.server.mcpserver.exceptions import ToolError  # mcp v2
+    except ImportError:  # 极老的 mcp 没有这个类：退回普通异常（消息会丢，但不至于起不来）
+        ToolError = RuntimeError  # type: ignore[assignment,misc]
+
 # ⚠️ 参数描述必须写成 `Annotated[T, Field(description=...)]`，**不能只靠 docstring 的 Args 段**。
 #    mcp v2（MCPServer）不再解析 docstring 的 Args —— 实测把整段 Args 当散文塞进工具描述，
 #    参数级 description 全是空的（2026-09-22 用真实 stdio 握手验证）。v1 两种都认，所以这样写两边通用。
@@ -70,7 +89,7 @@ def _get(path: str, params: Optional[dict] = None) -> dict:
     也没有可重试的标题（2026-09-22 用真 key 实测，三份实现里这份丢得最干净）。
     """
     if not API_KEY:
-        raise RuntimeError(
+        raise ToolError(
             "Missing DATASINK_API_KEY environment variable (get a free key at https://datasink.ing)"
         )
     p = dict(params or {})
@@ -87,7 +106,8 @@ def _get(path: str, params: Optional[dict] = None) -> dict:
         available = body.get("available")
         if isinstance(available, list):
             msg += "\nAvailable sections: " + json.dumps(available, ensure_ascii=False)
-        raise RuntimeError(msg)
+        # ToolError 而非 RuntimeError —— 否则 mcp v2 把 msg 剥成通用句，见文件顶部注释
+        raise ToolError(msg)
     return r.json()
 
 

{datasinking-0.2.11 → datasinking-0.2.13}/datasinking.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datasinking
-Version: 0.2.11
+Version: 0.2.13
 Summary: Python client for DataSinking — full-text Asian financial reports (China, Korea, Japan, Taiwan) as Markdown.
 Author: DataSinking
 License: MIT
@@ -41,20 +41,21 @@ with YAML frontmatter, preserved headings, paragraphs and tables.
 
 ## MCP server
 
-Ship DataSinking to any AI agent (Claude / Cursor / Codex / Windsurf) as an
+Ship DataSinking to any AI agent (Claude / Cursor / Codex / Devin Desktop) as an
 [MCP](https://modelcontextprotocol.io) server — 6 tools: list exchanges, list stocks,
 list reports, fetch a report, list sections, fetch one section (token-friendly for RAG).
 
 ### Hosted — nothing to install
 
-Point any MCP client at our endpoint and you're done. No package, no Python, no local server:
+One URL, no package, no Python, no local server. Most clients take this shape:
 
 ```json
 {
   "mcpServers": {
     "datasinking": {
       "type": "http",
-      "url": "https://api.datasink.ing/mcp?apikey=YOUR_KEY"
+      "url": "https://api.datasink.ing/mcp",
+      "headers": { "Authorization": "Bearer YOUR_KEY" }
     }
   }
 }
@@ -67,9 +68,12 @@ claude mcp add --transport http datasinking https://api.datasink.ing/mcp \
   --header "Authorization: Bearer YOUR_KEY"
 ```
 
-Your key rides inside the URL, so treat that config as a secret. Clients that support custom
-headers can send `Authorization: Bearer YOUR_KEY` instead — Claude Code redacts headers in its
-output but can't redact a URL.
+A client that can't set a header can put the key in the URL instead —
+`https://api.datasink.ing/mcp?apikey=YOUR_KEY` — but only do that when you must: a key in a URL
+ends up in logs and screen shares, and no client can redact it.
+
+Two clients don't fit the shape above: Codex's config is TOML, and Devin Desktop's remote field is
+`serverUrl`, not `url`. Per-client files: [`docs/mcp/`](docs/mcp/).
 
 ### Local — run it yourself
 
@@ -104,8 +108,9 @@ kept in lockstep by [`check_mcp_parity.py`](check_mcp_parity.py).
 
 Full per-client setup: [`mcp-server.md`](mcp-server.md) (overview) ·
 [`docs/mcp/`](docs/mcp/) (one guide per client).
-Hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, no session id, and every
-client needs a restart after a config change. That trips up most first connections.
+
+The hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, and no session id is
+issued. Most clients read MCP config at launch, so restart one after changing its config.
 
 ![DataSinking MCP in Claude](docs/images/mcp-demo.png)
 
@@ -119,8 +124,8 @@ datasinking/
 ├── research/     # Research notes / blog posts (reproducing paper-style presentation)
 ├── datasinking/  # Python client + MCP server — pip install "datasinking[mcp]"
 ├── npm/          # The same MCP server on npm — npx -y datasinking-mcp (Node 18+)
-├── docs/mcp/     # Per-client MCP setup: Claude Code, Claude Desktop, Cursor, Codex, WorkBuddy
-├── mcp-server.md # MCP server overview — the two config shapes, tools, endpoint limits
+├── docs/mcp/     # Per-client MCP setup — Claude Code, Desktop, Cursor, Codex, WorkBuddy, Devin…
+├── mcp-server.md # MCP server overview — endpoint, per-client table, tools, troubleshooting
 ├── llm-examples.md  # Ask an LLM — no code needed (8 end-to-end examples)
 ├── api-examples.md  # 7 examples × 3 interfaces (curl / Python / LLM)
 └── README.md
@@ -135,9 +140,10 @@ errors that client actually produces:
 | Claude Desktop | [`docs/mcp/claude-desktop.md`](docs/mcp/claude-desktop.md) |
 | OpenAI Codex CLI | [`docs/mcp/codex.md`](docs/mcp/codex.md) |
 | WorkBuddy / CodeBuddy | [`docs/mcp/workbuddy.md`](docs/mcp/workbuddy.md) |
+| Doubao Work / 豆包工作 | [`docs/mcp/doubao.md`](docs/mcp/doubao.md) |
 | Cursor | [`docs/mcp/cursor.md`](docs/mcp/cursor.md) |
-| DeepSeek | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
-| Windsurf | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.md) |
+| DeepSeek Harness (`dsh`) | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
+| Devin Desktop | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.md) |
 
 ## Quick start