Skip to main content
Glama

negaresh (نگارش)

ci PyPI License: MIT

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.md folder) 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 (uvx must 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 serve

Claude Code (plugin: skill and MCP server together)

In Claude Code:

/plugin marketplace add Aricept094/negaresh
/plugin install negaresh@negaresh

Or from a terminal:

claude plugin marketplace add Aricept094/negaresh
claude plugin install negaresh@negaresh

Claude 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 serve

For the skill, copy skills/negaresh to ~/.codex/skills/negaresh.

Gemini CLI

gemini extensions install https://github.com/Aricept094/negaresh

Cursor

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 serve

  • Streamable HTTP: uvx negaresh serve --http --port 8000, then connect to http://127.0.0.1:8000/mcp. Use --allowed-host <name> for a proxy or tunnel host.

  • With pip: pip install negaresh, then negaresh 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

search_rules

Find rules by Persian or English words.

get_rule

One rule in full.

get_profile

Conventions for a kind of text (academic, journalistic, literary, ...).

check_mechanics

Checks M01 to M16. It returns findings with exact offsets, candidate patches, and a low-risk auto_patch_set.

validate_patches

Checks that a set of edits applies cleanly and leaves URLs, code and other protected text unchanged.

search, fetch

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 doctor
negaresh check draft.txt --profile academic
negaresh 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

  1. Edit the JSON in corpus/rules/.

  2. Run python tools/build.py. It validates the corpus and regenerates the bundle, the skill references and the rule book.

  3. 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…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Bareun (바른) 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://ap
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides 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.
      4
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      11
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      5
      14 npm
      MIT