datasinking-mcp 0.1.0__tar.gz

datasinking_mcp-0.1.0/LICENSE

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

datasinking_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: datasinking-mcp
+Version: 0.1.0
+Summary: MCP server for DataSinking — full-text Asian financial reports (China, Korea, Japan) as Markdown, for AI agents.
+Author: DataSinking
+License: MIT
+Project-URL: Homepage, https://datasink.ing
+Project-URL: Documentation, https://datasink.ing/docs
+Project-URL: Repository, https://github.com/heubme2020/datasinking-mcp
+Keywords: mcp,model-context-protocol,financial-reports,a-share,korea,japan,markdown,rag,llm,ai
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: requests>=2.28
+Dynamic: license-file
+
+# DataSinking MCP
+
+[![PyPI version](https://img.shields.io/pypi/v/datasinking-mcp.svg)](https://pypi.org/project/datasinking-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-Protocol-orange.svg)](https://modelcontextprotocol.io)
+[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org)
+
+**Asian financial reports as full-text Markdown, for AI agents.**
+
+An [MCP](https://modelcontextprotocol.io) server that exposes the
+[DataSinking](https://datasink.ing) API to any MCP-compatible AI client
+(Claude, Cursor, Codex, DeepSeek, Windsurf, …). Ask for a company's annual
+report, a specific chapter (MD&A, risk, notes), or explore coverage — no code
+needed.
+
+- **Full-text Markdown** — China (SSE/SZSE/BSE) · Korea (KOSPI/KOSDAQ/KONEX) · Japan (TSE)
+- **Chapter-level access** — pull just the MD&A / risk section to save tokens (built for RAG)
+- **FMP-style symbols** — `600519.SS` (Moutai), `005930.KS` (Samsung), `7203.T` (Toyota)
+
+## Quick start
+
+```bash
+# 1. Get a free API key (no credit card):
+#    https://datasink.ing  →  POST /free-key
+export DATASINK_API_KEY="YOUR_KEY"
+
+# 2. Add to Claude Code:
+claude mcp add datasinking -e DATASINK_API_KEY="$DATASINK_API_KEY" -- uvx datasinking-mcp
+```
+
+Or add to any MCP client's config (same `command` + `args` + `env` shape):
+
+```json
+{
+  "mcpServers": {
+    "datasinking": {
+      "command": "uvx",
+      "args": ["datasinking-mcp"],
+      "env": { "DATASINK_API_KEY": "YOUR_KEY" }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does | API |
+|------|-------------|-----|
+| `list_exchanges` | List covered exchanges | `/exchanges` |
+| `list_stocks(exchange)` | List stocks on an exchange | `/stocks` |
+| `list_reports(symbol, doc_type, size)` | List a company's reports (metadata) | `/documents` |
+| `get_report(document_id)` | Get a report's full text | `/documents/{id}` |
+| `list_sections(document_id)` | List a report's section headings | `/documents/{id}/sections` |
+| `get_section(document_id, section)` | Get one section only (token-efficient, for RAG) | `/documents/{id}?section=` |
+
+## Supported clients
+
+MCP is an open standard; these clients connect the same way:
+
+| Client | How to add |
+|--------|------------|
+| Claude Code | `claude mcp add datasinking -- uvx datasinking-mcp` |
+| Claude Desktop | `Settings → Developer → Edit Config` (JSON above) |
+| Cursor | `Settings → MCP → Add server` (JSON above) |
+| OpenAI Codex | `~/.codex/config.toml` → `[mcp_servers.datasinking]` |
+| Windsurf | `Settings → MCP` |
+| DeepSeek | MCP config (JSON above) |
+
+## Install from source
+
+```bash
+pip install datasinking-mcp
+```
+
+Requires Python 3.10+ and a DataSinking API key ([free](https://datasink.ing)).
+
+## Docs
+
+- API reference: <https://datasink.ing/docs>
+- OpenAPI spec: <https://api.datasink.ing/openapi.json>
+- LLM examples: <https://github.com/heubme2020/datasinking/blob/main/llm-examples.md>
+
+## License
+
+[MIT](LICENSE)

datasinking_mcp-0.1.0/README.md

@@ -0,0 +1,85 @@
+# DataSinking MCP
+
+[![PyPI version](https://img.shields.io/pypi/v/datasinking-mcp.svg)](https://pypi.org/project/datasinking-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-Protocol-orange.svg)](https://modelcontextprotocol.io)
+[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org)
+
+**Asian financial reports as full-text Markdown, for AI agents.**
+
+An [MCP](https://modelcontextprotocol.io) server that exposes the
+[DataSinking](https://datasink.ing) API to any MCP-compatible AI client
+(Claude, Cursor, Codex, DeepSeek, Windsurf, …). Ask for a company's annual
+report, a specific chapter (MD&A, risk, notes), or explore coverage — no code
+needed.
+
+- **Full-text Markdown** — China (SSE/SZSE/BSE) · Korea (KOSPI/KOSDAQ/KONEX) · Japan (TSE)
+- **Chapter-level access** — pull just the MD&A / risk section to save tokens (built for RAG)
+- **FMP-style symbols** — `600519.SS` (Moutai), `005930.KS` (Samsung), `7203.T` (Toyota)
+
+## Quick start
+
+```bash
+# 1. Get a free API key (no credit card):
+#    https://datasink.ing  →  POST /free-key
+export DATASINK_API_KEY="YOUR_KEY"
+
+# 2. Add to Claude Code:
+claude mcp add datasinking -e DATASINK_API_KEY="$DATASINK_API_KEY" -- uvx datasinking-mcp
+```
+
+Or add to any MCP client's config (same `command` + `args` + `env` shape):
+
+```json
+{
+  "mcpServers": {
+    "datasinking": {
+      "command": "uvx",
+      "args": ["datasinking-mcp"],
+      "env": { "DATASINK_API_KEY": "YOUR_KEY" }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does | API |
+|------|-------------|-----|
+| `list_exchanges` | List covered exchanges | `/exchanges` |
+| `list_stocks(exchange)` | List stocks on an exchange | `/stocks` |
+| `list_reports(symbol, doc_type, size)` | List a company's reports (metadata) | `/documents` |
+| `get_report(document_id)` | Get a report's full text | `/documents/{id}` |
+| `list_sections(document_id)` | List a report's section headings | `/documents/{id}/sections` |
+| `get_section(document_id, section)` | Get one section only (token-efficient, for RAG) | `/documents/{id}?section=` |
+
+## Supported clients
+
+MCP is an open standard; these clients connect the same way:
+
+| Client | How to add |
+|--------|------------|
+| Claude Code | `claude mcp add datasinking -- uvx datasinking-mcp` |
+| Claude Desktop | `Settings → Developer → Edit Config` (JSON above) |
+| Cursor | `Settings → MCP → Add server` (JSON above) |
+| OpenAI Codex | `~/.codex/config.toml` → `[mcp_servers.datasinking]` |
+| Windsurf | `Settings → MCP` |
+| DeepSeek | MCP config (JSON above) |
+
+## Install from source
+
+```bash
+pip install datasinking-mcp
+```
+
+Requires Python 3.10+ and a DataSinking API key ([free](https://datasink.ing)).
+
+## Docs
+
+- API reference: <https://datasink.ing/docs>
+- OpenAPI spec: <https://api.datasink.ing/openapi.json>
+- LLM examples: <https://github.com/heubme2020/datasinking/blob/main/llm-examples.md>
+
+## License
+
+[MIT](LICENSE)

datasinking_mcp-0.1.0/datasinking_mcp/__init__.py

@@ -0,0 +1,6 @@
+"""DataSinking MCP server — Asian financial reports (China, Korea, Japan) as Markdown, for AI agents."""
+
+from .server import main, mcp
+
+__all__ = ["mcp", "main"]
+__version__ = "0.1.0"

datasinking_mcp-0.1.0/datasinking_mcp/server.py

@@ -0,0 +1,109 @@
+# -*- coding: utf-8 -*-
+"""DataSinking MCP server.
+
+Expose the DataSinking API — full-text financial reports across Asia
+(China, Korea, Japan) as clean Markdown — to AI agents via MCP.
+
+Run via ``uvx datasinking-mcp`` (stdio), or ``python -m datasinking_mcp``.
+Requires the environment variable ``DATASINK_API_KEY`` (get a free key at
+https://datasink.ing).
+"""
+
+import os
+
+import requests
+
+# mcp v1 uses FastMCP; v2 renamed it to MCPServer. Support both.
+try:
+    from mcp.server.fastmcp import FastMCP  # mcp v1
+except ImportError:  # pragma: no cover
+    from mcp.server.mcpserver import MCPServer as FastMCP  # mcp v2
+
+BASE_URL = "https://api.datasink.ing"
+API_KEY = os.environ.get("DATASINK_API_KEY", "")
+
+mcp = FastMCP(
+    "DataSinking",
+    instructions=(
+        "DataSinking 提供亚洲（中国/韩国/日本）上市公司财报的全文 Markdown。"
+        "symbol 用 FMP 风格：600519.SS（茅台）、005930.KS（三星）、7203.T（丰田）。"
+        "要省 token 时用 get_section 只取某一章（如 MD&A），而不是 get_report 拿整篇。"
+    ),
+)
+
+
+def _get(path: str, params: dict | None = None) -> dict:
+    """Call the DataSinking API, carrying the API key automatically."""
+    if not API_KEY:
+        raise RuntimeError("缺少 DATASINK_API_KEY 环境变量（去 datasink.ing 免费拿一个）")
+    p = dict(params or {})
+    p["apikey"] = API_KEY
+    r = requests.get(f"{BASE_URL}{path}", params=p, timeout=90)
+    r.raise_for_status()
+    return r.json()
+
+
+@mcp.tool()
+def list_exchanges() -> list:
+    """列出 DataSinking 覆盖的交易所代码（sse/szse/bj/ksc/koe/knx/jpx）。"""
+    return _get("/exchanges").get("exchanges", [])
+
+
+@mcp.tool()
+def list_stocks(exchange: str, limit: int = 20) -> dict:
+    """列出某交易所的股票（含每家公司的报告数）。
+
+    Args:
+        exchange: 交易所代码，如 sse / szse / ksc / koe / jpx
+        limit: 返回前 N 家（默认 20，防止列表过长）
+    """
+    data = _get("/stocks", {"exchange": exchange})
+    return {"exchange": exchange, "total": data.get("total", 0), "items": data.get("items", [])[:limit]}
+
+
+@mcp.tool()
+def list_reports(symbol: str, doc_type: str = "annual", size: int = 10) -> dict:
+    """列出某公司的报告（元数据，不含正文）。
+
+    Args:
+        symbol: FMP 风格代码，如 600519.SS / 005930.KS / 7203.T
+        doc_type: annual / semiannual / q1 / q3
+        size: 返回条数（默认 10）
+    """
+    return _get("/documents", {"symbol": symbol, "doc_type": doc_type, "size": size})
+
+
+@mcp.tool()
+def get_report(document_id: int) -> dict:
+    """获取单篇报告的全文（元数据 + Markdown 正文）。
+
+    Args:
+        document_id: 报告 ID，从 list_reports 的 items[].id 拿
+    """
+    return _get(f"/documents/{document_id}")
+
+
+@mcp.tool()
+def list_sections(document_id: int) -> dict:
+    """列出某报告的所有章节标题（供 get_section 用）。"""
+    return _get(f"/documents/{document_id}/sections")
+
+
+@mcp.tool()
+def get_section(document_id: int, section: str) -> dict:
+    """只取报告的某一章（省 token，适合 RAG）。
+
+    Args:
+        document_id: 报告 ID
+        section: 章节标题的关键词，如 "管理层讨论与分析" / "MD&A" / "财务报告"
+    """
+    return _get(f"/documents/{document_id}", {"section": section})
+
+
+def main() -> None:
+    """Entry point for ``uvx datasinking-mcp``."""
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

datasinking_mcp-0.1.0/datasinking_mcp.egg-info/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: datasinking-mcp
+Version: 0.1.0
+Summary: MCP server for DataSinking — full-text Asian financial reports (China, Korea, Japan) as Markdown, for AI agents.
+Author: DataSinking
+License: MIT
+Project-URL: Homepage, https://datasink.ing
+Project-URL: Documentation, https://datasink.ing/docs
+Project-URL: Repository, https://github.com/heubme2020/datasinking-mcp
+Keywords: mcp,model-context-protocol,financial-reports,a-share,korea,japan,markdown,rag,llm,ai
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: requests>=2.28
+Dynamic: license-file
+
+# DataSinking MCP
+
+[![PyPI version](https://img.shields.io/pypi/v/datasinking-mcp.svg)](https://pypi.org/project/datasinking-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-Protocol-orange.svg)](https://modelcontextprotocol.io)
+[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org)
+
+**Asian financial reports as full-text Markdown, for AI agents.**
+
+An [MCP](https://modelcontextprotocol.io) server that exposes the
+[DataSinking](https://datasink.ing) API to any MCP-compatible AI client
+(Claude, Cursor, Codex, DeepSeek, Windsurf, …). Ask for a company's annual
+report, a specific chapter (MD&A, risk, notes), or explore coverage — no code
+needed.
+
+- **Full-text Markdown** — China (SSE/SZSE/BSE) · Korea (KOSPI/KOSDAQ/KONEX) · Japan (TSE)
+- **Chapter-level access** — pull just the MD&A / risk section to save tokens (built for RAG)
+- **FMP-style symbols** — `600519.SS` (Moutai), `005930.KS` (Samsung), `7203.T` (Toyota)
+
+## Quick start
+
+```bash
+# 1. Get a free API key (no credit card):
+#    https://datasink.ing  →  POST /free-key
+export DATASINK_API_KEY="YOUR_KEY"
+
+# 2. Add to Claude Code:
+claude mcp add datasinking -e DATASINK_API_KEY="$DATASINK_API_KEY" -- uvx datasinking-mcp
+```
+
+Or add to any MCP client's config (same `command` + `args` + `env` shape):
+
+```json
+{
+  "mcpServers": {
+    "datasinking": {
+      "command": "uvx",
+      "args": ["datasinking-mcp"],
+      "env": { "DATASINK_API_KEY": "YOUR_KEY" }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does | API |
+|------|-------------|-----|
+| `list_exchanges` | List covered exchanges | `/exchanges` |
+| `list_stocks(exchange)` | List stocks on an exchange | `/stocks` |
+| `list_reports(symbol, doc_type, size)` | List a company's reports (metadata) | `/documents` |
+| `get_report(document_id)` | Get a report's full text | `/documents/{id}` |
+| `list_sections(document_id)` | List a report's section headings | `/documents/{id}/sections` |
+| `get_section(document_id, section)` | Get one section only (token-efficient, for RAG) | `/documents/{id}?section=` |
+
+## Supported clients
+
+MCP is an open standard; these clients connect the same way:
+
+| Client | How to add |
+|--------|------------|
+| Claude Code | `claude mcp add datasinking -- uvx datasinking-mcp` |
+| Claude Desktop | `Settings → Developer → Edit Config` (JSON above) |
+| Cursor | `Settings → MCP → Add server` (JSON above) |
+| OpenAI Codex | `~/.codex/config.toml` → `[mcp_servers.datasinking]` |
+| Windsurf | `Settings → MCP` |
+| DeepSeek | MCP config (JSON above) |
+
+## Install from source
+
+```bash
+pip install datasinking-mcp
+```
+
+Requires Python 3.10+ and a DataSinking API key ([free](https://datasink.ing)).
+
+## Docs
+
+- API reference: <https://datasink.ing/docs>
+- OpenAPI spec: <https://api.datasink.ing/openapi.json>
+- LLM examples: <https://github.com/heubme2020/datasinking/blob/main/llm-examples.md>
+
+## License
+
+[MIT](LICENSE)

datasinking_mcp-0.1.0/datasinking_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+datasinking_mcp/__init__.py
+datasinking_mcp/server.py
+datasinking_mcp.egg-info/PKG-INFO
+datasinking_mcp.egg-info/SOURCES.txt
+datasinking_mcp.egg-info/dependency_links.txt
+datasinking_mcp.egg-info/entry_points.txt
+datasinking_mcp.egg-info/requires.txt
+datasinking_mcp.egg-info/top_level.txt

datasinking_mcp-0.1.0/datasinking_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

datasinking_mcp-0.1.0/datasinking_mcp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+datasinking-mcp = datasinking_mcp.server:main

datasinking_mcp-0.1.0/datasinking_mcp.egg-info/requires.txt

@@ -0,0 +1,2 @@
+mcp>=1.0.0
+requests>=2.28

datasinking_mcp-0.1.0/datasinking_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+datasinking_mcp

datasinking_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "datasinking-mcp"
+version = "0.1.0"
+description = "MCP server for DataSinking — full-text Asian financial reports (China, Korea, Japan) as Markdown, for AI agents."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "DataSinking" }]
+keywords = ["mcp", "model-context-protocol", "financial-reports", "a-share", "korea", "japan", "markdown", "rag", "llm", "ai"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Office/Business :: Financial",
+]
+dependencies = ["mcp>=1.0.0", "requests>=2.28"]
+
+[project.urls]
+Homepage = "https://datasink.ing"
+Documentation = "https://datasink.ing/docs"
+Repository = "https://github.com/heubme2020/datasinking-mcp"
+
+[project.scripts]
+datasinking-mcp = "datasinking_mcp.server:main"
+
+[tool.setuptools]
+packages = ["datasinking_mcp"]

datasinking_mcp-0.1.0/setup.cfg

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