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.0

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.0
File Size Uploaded Provenance Actions
souyun_mcp-0.1.0.tar.gz 89.9 kB Without provenance Details for souyun_mcp-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 100.5 kB

Release files / souyun_mcp-0.1.0.tar.gz

Download URL souyun_mcp-0.1.0.tar.gz
Size 89.9 kB
Tags Source
SHA-256 checksum
How to use checksums
76e283b5eb168b3377501900dfa95fcba42d59887fd9d14ddfc14ae689c3d181
BLAKE2b-256 checksum
How to use checksums
519c0acd5539f136a5779e3e5439d226dbac844b8637709f0232bf21f363d921
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.0-py3-none-any.whl

Download URL souyun_mcp-0.1.0-py3-none-any.whl
Size 10.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
428f3362c72f57ee57772e8ef7e1ef26a76529c6e144f7f67816b73b85b28dd7
BLAKE2b-256 checksum
How to use checksums
bc3e78f613b6f6e426abdfb20d788dccefdbfc87cdc6f63f0cb35eb43f3fad59
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.0

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.0 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