Skip to main content

souyun-mcp

A Python stdio MCP server that wraps the sou-yun.cn 律诗校验 tool (https://www.sou-yun.cn/manalyzepoem.aspx), which checks the 平仄 and rhyme of Chinese regulated verse (律诗 / 绝句).

Tool

check_poem

arg default description
poem (required) Full poem text with punctuation, one poem per call
rhyme_book "ty" "ty" = 中华通韵 (manalyzepoem.aspx), "psy" = 平水韵 (analyzepoem.aspx)
enable_self_jiu true Allow 本句自救
enable_other_jiu false Allow 对句相救
include_rhyme_chars false Include the (long) list of characters in the rhyme group
max_suggestions 40 Max replacement words listed per problem
output_format "text" "text" report, or "json" structured data

The output includes the form and rhyme (e.g. 五言律诗 押侵韵), the 平仄 line for each couplet, characters flagged as 平仄有误 / 用韵错误 / 多音字需自校 with their sentence and position, notes like 孤平/三平尾/失粘/拗救, repeated-character warnings, details for polyphonic and out-of-rhyme characters, and suggested replacement words.

Install / run

From PyPI (no clone needed):

uvx souyun-mcp          # run directly with uv
pip install souyun-mcp  # or install, then run `souyun-mcp`

From source:

cd w:\fun_workspace\souyun-mcp
uv sync            # or: pip install -e .
uv run souyun-mcp  # starts the stdio server (normally your MCP client launches it)

MCP client config

Cline / Claude Desktop / Cursor (mcpServers JSON), using the PyPI package:

{
  "mcpServers": {
    "souyun": { "command": "uvx", "args": ["souyun-mcp"] }
  }
}

From a local checkout:

{
  "mcpServers": {
    "souyun": {
      "command": "uv",
      "args": ["--directory", "w:\\fun_workspace\\souyun-mcp", "run", "souyun-mcp"]
    }
  }
}

Without uv, after pip install -e .:

{ "mcpServers": { "souyun": { "command": "python", "args": ["-m", "souyun_mcp"] } } }

Test

uv run python tests/smoke_test.py

Notes

  • This tool scrapes the public web page, so it can break if sou-yun.cn changes its HTML. Please use it moderately.
  • The site rejects requests that don't send a browser User-Agent, so the client sends one.

Metadata

Release files for souyun-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for souyun-mcp 0.1.1
File Size Uploaded Provenance Actions
souyun_mcp-0.1.1.tar.gz 90.1 kB Without provenance Details for souyun_mcp-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for souyun-mcp 0.1.1
File Interpreter ABI Platform Actions
souyun_mcp-0.1.1-py3-none-any.whl Python 3 none any Details for souyun_mcp-0.1.1-py3-none-any.whl

Total release size: 100.8 kB

Release files / souyun_mcp-0.1.1.tar.gz

Download URL souyun_mcp-0.1.1.tar.gz
Size 90.1 kB
Tags Source
SHA-256 checksum
How to use checksums
84c1d8f28d846219008cc6cedb12a75c3de08f21f748502025f87b48c858219e
BLAKE2b-256 checksum
How to use checksums
22c08ab4c7c1585bcdafb89058bcc9fffc907be47adc5b2a53deeebb365f658f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Release files / souyun_mcp-0.1.1-py3-none-any.whl

Download URL souyun_mcp-0.1.1-py3-none-any.whl
Size 10.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5147e3b242ab35f5b32b2ee63f7a394b872270a6b78bea8fc0a4c31eb0c1a1d6
BLAKE2b-256 checksum
How to use checksums
ee3f432aee1f761c681649cc6e200c6b064c71f2c8ec7427c6fb75003cd4d7dd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Security for souyun-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page