1102-mcp 0.1.0__tar.gz

1102_mcp-0.1.0/1102_mcp.egg-info/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: 1102-mcp
+Version: 0.1.0
+Summary: Add your description here
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp>=4.1.5
+Requires-Dist: msgpack>=1.1.0
+
+# 搜韵诗词 MCP
+
+基于搜韵网开放接口的 FastMCP 服务，通过 stdio 向 MCP 客户端提供诗词检索、韵典查询和歌词素材汇总工具。
+
+## 环境准备
+
+- Python 3.13 或更高版本
+- [uv](https://docs.astral.sh/uv/)
+- 运行时可访问 `api.sou-yun.cn`
+
+在项目目录安装依赖：
+
+```powershell
+uv sync
+```
+
+## 启动
+
+MCP 服务使用 stdio，由 MCP 客户端按需启动并管理进程：
+
+```powershell
+uv run python .\souyun_mcp.py
+```
+
+也可以直接使用项目虚拟环境：
+
+```powershell
+.\.venv\Scripts\python.exe .\souyun_mcp.py
+```
+
+## MCP 客户端配置
+
+在客户端的 MCP 配置中添加一个 stdio server。将示例中的目录替换为本机项目的绝对路径：
+
+```json
+{
+  "mcpServers": {
+    "souyun-poem": {
+      "command": "D:\\path\\to\\1102-mcp\\.venv\\Scripts\\python.exe",
+      "args": [
+        "D:\\path\\to\\1102-mcp\\souyun_mcp.py"
+      ]
+    }
+  }
+}
+```
+
+## 可用工具
+
+- `search_poems`: 按关键词检索诗词。`scope` 支持 `All`、`Author`、`Title`、`Sentence` 或数字 `0` 到 `3`；也可按 `dynasty`、`type_`、`rhyme` 和 `pageno` 筛选，`jsontype` 控制 JSON 返回格式。
+- `get_poem`: 按 `poem_id` 查询单首诗词详情。
+- `rhyme_dictionary`: 按 `char` 查询韵典；`qtype` 为 `0` 查全部、`1` 查韵目、`2` 查词末典故、`3` 查词首、`4` 查词末、`5` 查句末诗例。可通过 `page_no` 翻页。
+- `couplet_words`: 查询与 `word` 对仗的词汇。
+- `rhyme_category`: 不传 `rhyme` 时查询平水韵总目；传入韵部时查询该韵包含的字。
+- `collect_lyrics_material`: 按 `theme` 汇总候选诗词、诗句和韵部建议。可设置 `top_n`、`dynasty`、`type_`；传入 `rhyme_char` 时还会返回相关对仗词和典故。

1102_mcp-0.1.0/1102_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+souyun_mcp.py
+1102_mcp.egg-info/PKG-INFO
+1102_mcp.egg-info/SOURCES.txt
+1102_mcp.egg-info/dependency_links.txt
+1102_mcp.egg-info/requires.txt
+1102_mcp.egg-info/top_level.txt

1102_mcp-0.1.0/1102_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

1102_mcp-0.1.0/1102_mcp.egg-info/requires.txt

@@ -0,0 +1,2 @@
+fastmcp>=4.1.5
+msgpack>=1.1.0

1102_mcp-0.1.0/1102_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+souyun_mcp

1102_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: 1102-mcp
+Version: 0.1.0
+Summary: Add your description here
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp>=4.1.5
+Requires-Dist: msgpack>=1.1.0
+
+# 搜韵诗词 MCP
+
+基于搜韵网开放接口的 FastMCP 服务，通过 stdio 向 MCP 客户端提供诗词检索、韵典查询和歌词素材汇总工具。
+
+## 环境准备
+
+- Python 3.13 或更高版本
+- [uv](https://docs.astral.sh/uv/)
+- 运行时可访问 `api.sou-yun.cn`
+
+在项目目录安装依赖：
+
+```powershell
+uv sync
+```
+
+## 启动
+
+MCP 服务使用 stdio，由 MCP 客户端按需启动并管理进程：
+
+```powershell
+uv run python .\souyun_mcp.py
+```
+
+也可以直接使用项目虚拟环境：
+
+```powershell
+.\.venv\Scripts\python.exe .\souyun_mcp.py
+```
+
+## MCP 客户端配置
+
+在客户端的 MCP 配置中添加一个 stdio server。将示例中的目录替换为本机项目的绝对路径：
+
+```json
+{
+  "mcpServers": {
+    "souyun-poem": {
+      "command": "D:\\path\\to\\1102-mcp\\.venv\\Scripts\\python.exe",
+      "args": [
+        "D:\\path\\to\\1102-mcp\\souyun_mcp.py"
+      ]
+    }
+  }
+}
+```
+
+## 可用工具
+
+- `search_poems`: 按关键词检索诗词。`scope` 支持 `All`、`Author`、`Title`、`Sentence` 或数字 `0` 到 `3`；也可按 `dynasty`、`type_`、`rhyme` 和 `pageno` 筛选，`jsontype` 控制 JSON 返回格式。
+- `get_poem`: 按 `poem_id` 查询单首诗词详情。
+- `rhyme_dictionary`: 按 `char` 查询韵典；`qtype` 为 `0` 查全部、`1` 查韵目、`2` 查词末典故、`3` 查词首、`4` 查词末、`5` 查句末诗例。可通过 `page_no` 翻页。
+- `couplet_words`: 查询与 `word` 对仗的词汇。
+- `rhyme_category`: 不传 `rhyme` 时查询平水韵总目；传入韵部时查询该韵包含的字。
+- `collect_lyrics_material`: 按 `theme` 汇总候选诗词、诗句和韵部建议。可设置 `top_n`、`dynasty`、`type_`；传入 `rhyme_char` 时还会返回相关对仗词和典故。

1102_mcp-0.1.0/README.md

@@ -0,0 +1,55 @@
+# 搜韵诗词 MCP
+
+基于搜韵网开放接口的 FastMCP 服务，通过 stdio 向 MCP 客户端提供诗词检索、韵典查询和歌词素材汇总工具。
+
+## 环境准备
+
+- Python 3.13 或更高版本
+- [uv](https://docs.astral.sh/uv/)
+- 运行时可访问 `api.sou-yun.cn`
+
+在项目目录安装依赖：
+
+```powershell
+uv sync
+```
+
+## 启动
+
+MCP 服务使用 stdio，由 MCP 客户端按需启动并管理进程：
+
+```powershell
+uv run python .\souyun_mcp.py
+```
+
+也可以直接使用项目虚拟环境：
+
+```powershell
+.\.venv\Scripts\python.exe .\souyun_mcp.py
+```
+
+## MCP 客户端配置
+
+在客户端的 MCP 配置中添加一个 stdio server。将示例中的目录替换为本机项目的绝对路径：
+
+```json
+{
+  "mcpServers": {
+    "souyun-poem": {
+      "command": "D:\\path\\to\\1102-mcp\\.venv\\Scripts\\python.exe",
+      "args": [
+        "D:\\path\\to\\1102-mcp\\souyun_mcp.py"
+      ]
+    }
+  }
+}
+```
+
+## 可用工具
+
+- `search_poems`: 按关键词检索诗词。`scope` 支持 `All`、`Author`、`Title`、`Sentence` 或数字 `0` 到 `3`；也可按 `dynasty`、`type_`、`rhyme` 和 `pageno` 筛选，`jsontype` 控制 JSON 返回格式。
+- `get_poem`: 按 `poem_id` 查询单首诗词详情。
+- `rhyme_dictionary`: 按 `char` 查询韵典；`qtype` 为 `0` 查全部、`1` 查韵目、`2` 查词末典故、`3` 查词首、`4` 查词末、`5` 查句末诗例。可通过 `page_no` 翻页。
+- `couplet_words`: 查询与 `word` 对仗的词汇。
+- `rhyme_category`: 不传 `rhyme` 时查询平水韵总目；传入韵部时查询该韵包含的字。
+- `collect_lyrics_material`: 按 `theme` 汇总候选诗词、诗句和韵部建议。可设置 `top_n`、`dynasty`、`type_`；传入 `rhyme_char` 时还会返回相关对仗词和典故。

1102_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "1102-mcp"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "fastmcp>=4.1.5",
+    "msgpack>=1.1.0",
+]
+
+[tool.setuptools]
+py-modules = ["souyun_mcp"]

1102_mcp-0.1.0/setup.cfg

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

1102_mcp-0.1.0/souyun_mcp.py

@@ -0,0 +1,176 @@
+"""FastMCP server for the Souyun open poem APIs."""
+
+import json
+from typing import Any
+from urllib.parse import urlencode
+from urllib.request import Request, urlopen
+
+from fastmcp import FastMCP
+
+API_BASE = "https://api.sou-yun.cn/open"
+REQUEST_TIMEOUT_SECONDS = 25
+
+mcp = FastMCP("搜韵诗词")
+
+
+def _get(path: str, params: dict[str, Any]) -> Any:
+    query = urlencode(
+        {key: value for key, value in params.items() if value is not None}
+    )
+    request = Request(
+        f"{API_BASE}{path}?{query}",
+        headers={"User-Agent": "Mozilla/5.0", "Accept": "application/json"},
+    )
+    with urlopen(request, timeout=REQUEST_TIMEOUT_SECONDS) as response:
+        return json.loads(response.read().decode("utf-8"))
+
+
+def _text(node: Any) -> str:
+    if isinstance(node, dict):
+        return node.get("Content") or node.get("content") or ""
+    if isinstance(node, str):
+        return node
+    return ""
+
+
+def _search_poems(
+    keyword: str,
+    scope: str | int = "All",
+    dynasty: str | None = None,
+    type_: str | None = None,
+    rhyme: str | None = None,
+    pageno: int = 0,
+    jsontype: bool = True,
+) -> Any:
+    params: dict[str, Any] = {
+        "key": keyword,
+        "scope": scope,
+        "jsontype": str(jsontype).lower(),
+        "pageno": pageno,
+    }
+    if dynasty:
+        params["dynasty"] = dynasty
+    if type_:
+        params["type"] = type_
+    if rhyme:
+        params["rhyme"] = rhyme
+    return _get("/poem", params)
+
+
+def _rhyme_dictionary(char: str, qtype: int = 0, page_no: int = 0) -> Any:
+    return _get("/rhymeDictionary", {"id": char, "qtype": qtype, "pageNo": page_no})
+
+
+def _couplet_words(word: str) -> Any:
+    return _get("/coupletwords", {"id": word})
+
+
+def _rhyme_category(rhyme: str | None = None) -> Any:
+    if rhyme:
+        return _get("/RhymeCategory", {"id": rhyme})
+    return _get("/RhymeCategory", {"list": ""})
+
+
+def _collect_lyrics_material(
+    theme: str,
+    top_n: int = 8,
+    rhyme_char: str | None = None,
+    dynasty: str | None = None,
+    type_: str | None = None,
+) -> dict[str, Any]:
+    poems = _search_poems(theme, scope="All", dynasty=dynasty, type_=type_, pageno=0)
+    poem_rows = (poems.get("ShiData") or [])[:top_n]
+
+    candidate_poems = []
+    candidate_lines = []
+    rhyme_count: dict[str, int] = {}
+    for poem in poem_rows:
+        candidate_poems.append(
+            {
+                "id": poem.get("Id"),
+                "title": _text(poem.get("Title")),
+                "author": poem.get("Author"),
+                "dynasty": poem.get("Dynasty"),
+                "type": poem.get("Type"),
+                "rhyme": poem.get("Rhyme"),
+            }
+        )
+        rhyme = poem.get("Rhyme")
+        if rhyme:
+            rhyme_count[rhyme] = rhyme_count.get(rhyme, 0) + 1
+        for clause in poem.get("Clauses") or []:
+            line = _text(clause)
+            if line:
+                candidate_lines.append(line)
+
+    result: dict[str, Any] = {
+        "theme": theme,
+        "candidate_poems": candidate_poems,
+        "candidate_lines": candidate_lines,
+        "rhyme_suggestions": rhyme_count,
+    }
+    if rhyme_char:
+        result["couplet_words"] = _couplet_words(rhyme_char)
+        dictionary = _rhyme_dictionary(rhyme_char)
+        result["allusions"] = (
+            dictionary.get("Allusions") if isinstance(dictionary, dict) else None
+        )
+    return result
+
+
+@mcp.tool
+def search_poems(
+    keyword: str,
+    scope: str | int = "All",
+    dynasty: str | None = None,
+    type_: str | None = None,
+    rhyme: str | None = None,
+    pageno: int = 0,
+    jsontype: bool = True,
+) -> Any:
+    """按关键词检索诗词；scope 可选 All、Author、Title、Sentence 或 0 到 3。"""
+    return _search_poems(keyword, scope, dynasty, type_, rhyme, pageno, jsontype)
+
+
+@mcp.tool
+def get_poem(poem_id: str) -> Any:
+    """按诗词 ID 获取单首详情。"""
+    return _get("/poem", {"key": poem_id, "jsontype": "true"})
+
+
+@mcp.tool
+def rhyme_dictionary(char: str, qtype: int = 0, page_no: int = 0) -> Any:
+    """查询韵典；qtype 为 0 查全部，1 查韵目，2 查词末典故，3/4 查词首/词末，5 查句末诗例。"""
+    return _rhyme_dictionary(char, qtype, page_no)
+
+
+@mcp.tool
+def couplet_words(word: str) -> Any:
+    """查询与输入字词对仗的词汇参考。"""
+    return _couplet_words(word)
+
+
+@mcp.tool
+def rhyme_category(rhyme: str | None = None) -> Any:
+    """查询平水韵总目，或查询指定韵部包含的字。"""
+    return _rhyme_category(rhyme)
+
+
+@mcp.tool
+def collect_lyrics_material(
+    theme: str,
+    top_n: int = 8,
+    rhyme_char: str | None = None,
+    dynasty: str | None = None,
+    type_: str | None = None,
+) -> dict[str, Any]:
+    """汇总主题相关诗词、诗句、韵部建议，可选附加对仗词和典故。"""
+    return _collect_lyrics_material(theme, top_n, rhyme_char, dynasty, type_)
+
+
+def main() -> None:
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()