negaresh
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
negaresh (نگارش)
A Persian (Farsi) writing guide for AI assistants and editors. It has three parts that work together or alone:
A rule set: 163 rules for Iranian standard Persian. They cover sentence structure and natural word order, verb tense and mood, paragraph flow, removing translated or machine-like Persian, grammar, usage, punctuation, numbers and citations, Academy orthography (نیمفاصله), and meaning preservation. Each rule has a test, examples, and a citation to the book it comes from.
A skill (standard Agent Skills
SKILL.mdfolder) for Claude, Codex and other agents: how to write, copyedit, proofread or naturalize (روانسازی) a Persian text with the rules.An MCP server (stdio and Streamable HTTP) for Claude, ChatGPT, Codex, Gemini CLI, Cursor, VS Code and any MCP client: deterministic checks (Arabic letters, digits, spacing, half-spaces, quotes, variant spellings, listed calques, and sentence shapes typical of machine Persian), rule search, and validation of edits before they are applied.
Status: draft (0.2.0). No human editor has approved the rules yet. Use them as suggestions and check important text yourself.
راهنمای نگارش فارسی برای دستیارهای هوش مصنوعی و ویراستاران: ۱۶۳ قاعده دربارهٔ ساخت جمله، ترتیب طبیعی اجزا، زمان و وجه فعل، پیوند بندها، زدودن نثر ترجمهای و ماشینی، دستور، کاربرد، نشانهگذاری و دستور خط فرهنگستان؛ با یک مهارت (skill) برای Claude و یک سرور MCP محلی برای بررسیهای مکانیکی. همهٔ قاعدهها پیشنویساند.
Sources
The rules were built from five books: the Academy's «دستور خطّ فارسی» (1401), Anvari and Ahmadi-Givi's «دستور زبان فارسی» 1 and 2, Arzhang's «دستور زبان فارسی امروز», and Samiee's «نگارش و ویرایش». The author bought the books, scanned them with OCR, extracted the rules, and rewrote and tuned them to the author's needs. The books are not included, and the skill and server cannot read or search them; the skill applies the rules, not the books. Full titles are in NOTICE.md.
Related MCP server: mcp-han
What it does
Task | Ask for | What happens |
Write | «این را به فارسی بنویس» / "write this in Persian" | The model writes with a real subject and a finite verb for each action, no stock frames, natural order and tense. |
Copyedit | «ویرایش کن» | Grammar, usage and spelling are fixed. Sentences with machine or translated shapes get a proposed rebuild. |
Naturalize | «روانش کن»، «طبیعیترش کن»، «ترجمهای است» | Sentences and paragraphs are rebuilt from their meaning. Facts, hedges, actors, numbers and names are kept. |
Proofread | «غلطگیری کن» | Characters, spacing, half-spaces, spelling and punctuation only. |
Ask | «این درست است؟» | The rule is found and cited. |
Requirements
For the MCP server: Python 3.11 or later and uv (
uvxmust be on the PATH). The server needs no network access while it runs.The skill and the rule set need nothing.
Install
The server is on PyPI and in the official MCP Registry as io.github.Aricept094/negaresh. The command is the same everywhere:
uvx negaresh serveClaude Code (plugin: skill and MCP server together)
In Claude Code:
/plugin marketplace add Aricept094/negaresh
/plugin install negaresh@negareshOr from a terminal:
claude plugin marketplace add Aricept094/negareshclaude plugin install negaresh@negareshClaude Desktop
Add the server to claude_desktop_config.json (Settings → Developer → Edit Config) and restart the app:
{
"mcpServers": {
"negaresh": {
"command": "uvx",
"args": ["negaresh", "serve"]
}
}
}For the skill, upload negaresh-skill.zip from the latest release under Settings → Capabilities → Skills.
Claude.ai
Upload negaresh-skill.zip from the latest release under Settings → Capabilities → Skills. The skill works without the server.
ChatGPT
Two ways, both in clients/chatgpt: an MCP connector in developer mode (run the server with --http behind an HTTPS tunnel), or a custom GPT with the rule files as knowledge.
Codex CLI
codex mcp add negaresh -- uvx negaresh serveFor the skill, copy skills/negaresh to ~/.codex/skills/negaresh.
Gemini CLI
gemini extensions install https://github.com/Aricept094/negareshCursor
Install in Cursor, or add the JSON block above to ~/.cursor/mcp.json.
VS Code
Install in VS Code, or:
code --add-mcp "{\"name\":\"negaresh\",\"command\":\"uvx\",\"args\":[\"negaresh\",\"serve\"]}"Any other MCP client
stdio:
uvx negaresh serveStreamable HTTP:
uvx negaresh serve --http --port 8000, then connect tohttp://127.0.0.1:8000/mcp. Use--allowed-host <name>for a proxy or tunnel host.With pip:
pip install negaresh, thennegaresh serve.Development version from GitHub:
uvx --from git+https://github.com/Aricept094/negaresh negaresh serve.
Skill only (any client that reads Agent Skills)
The skill is a standard SKILL.md folder: skills/negaresh. Copy it into the client's skills folder (~/.claude/skills/, ~/.codex/skills/, or the client's own location).
Rule set only
corpus/rules/*.json: the rules as JSON (one array per category).docs/RULEBOOK__NEEDS-INPUT.md: the full rule book in Persian.corpus/lexicon/: variant spellings, listed expressions and sentence-shape patterns.
MCP tools
Tool | Use |
| Find rules by Persian or English words. |
| One rule in full. |
| Conventions for a kind of text (academic, journalistic, literary, ...). |
| Checks M01 to M16. It returns findings with exact offsets, candidate patches, and a low-risk |
| Checks that a set of edits applies cleanly and leaves URLs, code and other protected text unchanged. |
| Over HTTP only: the search-and-read pair that ChatGPT connectors use. |
All tools are read-only. The server stores no text on disk. Each call takes up to 12,000 Unicode code points.
Command line
negaresh doctornegaresh check draft.txt --profile academicnegaresh search "نیمفاصله می"Rule families
Prefix | Family | Rules | Main sources |
ORT | Orthography and spacing | 44 | Academy «دستور خطّ فارسی» (1401) |
GRM | Grammar, word order, tense and mood | 39 | Anvari and Ahmadi-Givi 1 and 2; Arzhang; Samiee |
USG | Usage and calques | 23 | the three grammars; Samiee |
STY | Style and sentence building | 19 | Samiee; editorial synthesis |
PUN | Punctuation and characters | 18 | Samiee |
TRM | Numbers, dates, citations, notes, names | 9 | Samiee |
INT | Meaning preservation | 6 | Samiee; editorial synthesis |
DSC | Paragraphs and discourse | 5 | Samiee |
Each rule has a severity (error, convention, advisory) and an evidence class. sourced rules name the book and page they come from; editorial_synthesis rules are editorial practice and are offered as suggestions only.
Edit the rules
Edit the JSON in
corpus/rules/.Run
python tools/build.py. It validates the corpus and regenerates the bundle, the skill references and the rule book.Run
pytest.
Do not edit generated files: src/negaresh/data/corpus.json, skills/negaresh/references/rules-*.md, docs/RULEBOOK__NEEDS-INPUT.md.
To make the release files (wheel, skill zip, clean folder): python tools/package.py.
Limits
The rules are drafts. No human editor has approved them.
The mechanical checker sees characters, listed expressions and a few sentence shapes. No finding does not mean that the prose is natural. Sentence and paragraph rebuilding is done by the model with the rules.
The «می» half-space check uses a closed list of verb stems.
Licence
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Error-actionability translation for MCP tool failures. $0.002/check.
Stateless PII redaction over MCP/REST. Free ≤1000 words or $0.01/call; file upload supported.
Evidence-readiness MCP server: validate, audit, and score briefs, memos, and evidence packs.
Hosted MCP for denial, prior auth, reimbursement, workflow validation, batch scoring, and feedback.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceBareun (바른) is a Korean natural-language engine. This MCP server lets any MCP-compatible client hand Korean text to a dedicated Korean engine instead of guessing: analyze_syntax (morphological analysis with 47 POS tags and beta homograph sense disambiguation), analyze_syntax_raw (raw model output), tokenize, correct_grammar (spelling and spacing correction), and list_pos_tags. Hosted at https://apMIT
- AlicenseAqualityCmaintenanceProvides AI models with tools to proofread and format Chinese text before delivery, covering typos, punctuation, casing, spacing, and platform-specific character limits. It runs as a zero-dependency MCP service so the model checks and fixes its own Chinese writing automatically.41MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to professionally edit Persian text by reading a draft, diagnosing its problems, and assembling a tailored checklist from a 1,577-note editorial knowledge base spanning orthography, punctuation, grammar, word choice, tone, and structure. It then runs staged cleanup, AI editing, independent review (up to four rounds), and final verification, returning a clean text plus a change report, and also exposes rule search, rule packs, and diff auditing for use in Claude Desktop, Cursor, n8n, or custom code.11MIT
- AlicenseAqualityCmaintenanceEnables deterministic, LLM-free checking of text against a prose editorial standard, returning violations with rule IDs, locations, severity, confidence, and suggested fixes, while also supporting safe fixes and writing measurements.514 npmMIT