noslop MCP server
Commit Nov 13, 2026A Rust-based linter that detects patterns in Japanese text and code comments that suggest AI-generated content.
Also known as owayo/noslop
- Stars
- 13
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 13, 2026
- License
- MIT
What is noslop MCP?
noslop is a Rust-based linter that detects patterns in Japanese text and code comments that suggest AI-generated content.
Summary generated from the project's README
About noslop MCP server
Detecting patterns in Japanese text and code comments that suggest AI-generated content is what noslop enables for developers and writers. This Rust-based linter identifies specific linguistic habits, such as repetitive sentence structures, predictable phrasing, and textbook-like compositions, to help users refine their writing. It operates locally on Linux, macOS, and Windows, providing feedback through a command-line interface or as an MCP server for AI agents.
Users can integrate the tool into their workflows using the noslop mcp command or via hooks for agents like Claude Code. The linter analyzes Markdown, HTML, and various programming languages by extracting comments and static strings using tree-sitter. It distinguishes between AI-generated patterns, labeled as slop, and general readability issues. Rather than providing a single score, it lists specific findings with varying levels of evidence strength and severity to help humans make informed decisions about their text.
What you can do with it
- 1Audit AI-generated documentationA developer can use the linter to find repetitive or predictable Japanese phrasing in Markdown files to ensure they sound natural.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableowayo/noslop is public and reachablegithub.com/owayo/noslop ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/owayo/noslop ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubnoslop は、日本語の文書やコード内のコメント・静的な文字列・JSX/HTML の文言を対象に、LLM が書いた文章に出やすい癖を決まった規則で指摘する Linter です。と言えるでしょう のような定型句、〜ではなく の対比の繰り返し、文の長さがそろいすぎた単調なリズム、見出しと太字だけで組んだ教科書的な構成を検出します。
noslop は「この文章は AI が書いた」と判定する道具ではありません。書き手は自分の文章の癖に気づきにくく、長い文書を目で追うと必ず見落としが出ます。noslop は疑わしい箇所を並べるところまでを受け持ち、直すか残すかは書き手が文脈で決めます。残すと決めた箇所には、理由を添えた抑制コメントを書けます。
文字種と語句のパターン、文長の統計で判定し、品詞で数えるルール(「の」の連鎖・連続漢字・名詞句の列挙・敬体と常体の混在)は、形態素解析の辞書で判定します。辞書を同梱した単一のバイナリで動き、起動も速く、大きなリポジトリでもファイルを並列に処理します。
機能
- 辞書を同梱: 形態素解析器 hasami の IPAdic の辞書をバイナリに同梱し、「の」の連鎖(P16)と連続漢字(P15)を品詞で判定する。インストールも設定も要らない(形態素解析の辞書)
- 手掛かりの強さを添える: すべてのルールが既定で動き、AI 臭さの指摘には手掛かりの強さ(強い・中程度・弱い)が付く。強さは人の文書 440 本と生成文書 390 本での出方で決め、件数が足りずに測れないものは検出の仕組みから判断する。人の文章にもよく出る語句は「弱い手掛かり」として示す。直す優先度は重大度で示し、強さを足し合わせて点数にはしない
- 2 つのレーン: AI 臭さ(
slop)と読みやすさ(readability)の指摘を分けて出す。文書全体の点数は出さず、指摘とその件数だけを並べる - Markdown を理解する: コードブロック・インラインコード・URL・文書の先頭の front matter(YAML の
---・TOML の+++)を除き、見出し・リスト・表・引用を区別して解析する。HTML ブロックの本文も、タグと表示属性を除いて検査する(script・style・pre・code・template・textarea・コメント・hiddenの要素は除く)。文書の途中の---は区切り線か見出しの下線として読み、本文を捨てない。先頭と途中の---の間に地の文があれば、front matter とはみなさない。本文全体を```markdownのフェンスで包んだ文書は、中身を本文として読み、包んでいることを S13 で指摘する - コードの文言も読む: コードのファイルは、tree-sitter で取り出したコメント、日本語の静的な文字列、JSX/HTML の本文・表示属性を検査する。CSS の
contentや Ruby の Unicode エスケープ、Rust・TOML の行継続も復号して読む。補間や別々のボタン名は独立した断片として扱い、指摘は元のファイルの行・列で示す(コードのコメントと静的な文言) - 括弧を考慮した文分割: 形態素解析器 hasami の辞書を使わない文分割を使う。「」や()の内側の句点では文を切らず、閉じ忘れた括弧があっても後続の文を巻き込まない。
Yahoo!ニュースのように文末記号を含む語の途中でも切らない - 判断を記録できる:
<!-- noslop-disable-next-line P01 -- 引用のため -->のように、残す理由を文書に書ける - CI 向けの出力: text(色付き)・JSON(安定したスキーマ)・GitHub Actions の注釈に対応する。既定ではジョブを落とさない
- AI エージェントに渡せる: 直す箇所をルールごとにまとめた改稿指示を、Markdown・JSON・TOON(同じ内容を少ないトークンで表す形式)で出せる。MCP サーバー(
noslop mcp)、Claude Code のフック(noslop hook claude-code。書いた直後、gws で Google ドキュメント・スプレッドシートに書き込む前、応答を終えたとき)、claw-hooks から呼ぶ入口(noslop hook commandなど)、スキル(noslop skill-install)で、書いた AI 自身に見直させる。gws の書き込み前に読める値とコマンドの形は連携方法にまとめた - 文体の混在を見直す: R20 が、全文が対象の文書で、本文全体のです・ます調と言い切りの混在を示す。引用・会話・独立した断片を除き、部分差分では判定を実行しない
- 短い決め台詞の反復を見直す: R21 が、見出しと短い一文段落で読点を挟む型の反復を情報として示す。単発・因果・手順などを除く。作者を判別する根拠にはならないので、直すかは文脈で決める(検出条件と測定結果)
- 変更した箇所だけを見直す:
noslop check --git-diffで、コミットしていない変更に重なる指摘を JSON・TOON などで取り出せる(変更した箇所の検査) - 改稿を比べる:
noslop diffで、改稿で新しく出た指摘・消えた数字や固有名詞・主語や依頼先に足した人や担当・文書全体に一律に当てた直しを確かめる。数値は万・億・兆や小数を丸めずに比べる(比較の範囲と限界) - 手元のコーパスで校正できる:
noslop calibrateで、人の文書と生成文書からルールごとの誤検知率・検出率・手掛かりの強さを測り、閾値を選ぶ
文言を読めるコードの言語(拡張子と設定は コードのコメントと静的な文言 にあります):
AI エージェントのフックによる修正例
Claude Code が書いたコードのコメントを noslop のフックで検査し、指摘を受けた Claude Code が文章を修正している様子です。

応答を終えたときのフック(Stop)は、コミットしていない変更に重なる指摘を返します。次の画面では、Claude Code が 2 件の指摘を文脈で見直し、言い換えにすぎない対比を肯定文に書き換えています。読み手の誤解を正す対比は、理由を添えて残しています。

設定手順は AI エージェントへの導入 を参照してください。
動作環境
- OS: macOS、Linux、Windows
- Rust: 1.98 以上(ソースからビルドする場合)
インストール
Homebrew (macOS/Linux)
brew install owayo/noslop/noslop
winget (Windows)
winget install owayo.noslop
Cargo
Rust 1.98 以上が必要です。
cargo install --git https://github.com/owayo/noslop --locked --no-default-features --features cli noslop
Cargo から直接入れる版は辞書を同梱しません。辞書を同梱した版は Homebrew・winget・GitHub Releases、またはソースから make install で入れられます。辞書本体は Git に置かず、ビルド前に固定した版と SHA-256 で取得・照合します。
GitHub Releases から
Releases から自分の環境のアーカイブを取得して展開し、noslop を PATH の通った場所に置きます。各リリースには、取得したファイルを確かめるための SHA256SUMS も添付しています。
| プラットフォーム | ファイル |
|---|---|
| Linux (x86_64) | noslop-x86_64-unknown-linux-gnu.tar.gz |
| Linux (ARM64) | noslop-aarch64-unknown-linux-gnu.tar.gz |
| macOS (Intel) | noslop-x86_64-apple-darwin.tar.gz |
| macOS (Apple Silicon) | noslop-aarch64-apple-darwin.tar.gz |
| Windows (x86_64) | noslop-x86_64-pc-windows-msvc.zip |
macOS でブラウザから取得した場合は、実行の前に隔離属性を外します: xattr -d com.apple.quarantine noslop。
ソースから
mise が必要です (Rust のツールチェーンは mise.toml で固定しています)。
git clone https://github.com/owayo/noslop.git
cd noslop
make install
make install は /usr/local/bin に入れます。場所を変えるときは INSTALL_PATH を指定します (例: make install INSTALL_PATH="$HOME/.local/bin")。
アーカイブには LICENSE と THIRD_PARTY_NOTICES.md も含まれます。Homebrew と winget での更新、スキルの導入先、ソースから入れる場合の指定は インストールの補足 を参照してください。
ソースからの導入では、Claude Code と Codex CLI のスキルも ~/.claude/skills/noslop/ と ~/.codex/skills/noslop/ に入ります。make uninstall はスキルを残します。
辞書のダウンロード(推奨)
インストール後は、同梱の IPAdic より語彙の多い辞書を取得することを推奨します。
noslop dict download
名前を省くと、hasami が推奨する ipadic-neologd-sudachi(IPAdic + NEologd + SudachiDict)を取得します。辞書を指定しない既定の auto では、次の実行から取得した辞書を使います。取得状況と使う辞書は noslop dict list で確認できます。
辞書の選び方や、同梱の辞書で校正した条件に合わせる設定は 形態素解析の辞書 を参照してください。
使い方
文書の意味や目的に沿った読みやすさはnoslop reviewで18観点から確認できます。目的・読者・必要情報を指定して依頼を作り、判定器や編集者が返した引用を原文と照合します。要点の順序、論理、曖昧さ、用語の定義などを確認候補として扱います。文章レビューにCLIとMCPの使い方をまとめています。
noslop review guide.md --purpose "初回の申込みを完了する" --audience "初めて使う人"
noslop check guide.md
S11は列挙の予告と実際の項目数、S12はMarkdown上で本文のない節を検査します。どちらも読みやすさのルールで、既定で「情報」の指摘を出します。
ファイルを指定して検査します。ディレクトリを渡すと、その配下の Markdown とテキストをまとめて検査します(.gitignore・.ignore・.noslopignore を尊重します)。
noslop check README.md
noslop check docs --genre tech
端末に出る AI 臭さの指摘には、1 行目の末尾に手掛かりの強さ([強い手掛かり]・[中程度の手掛かり]・[弱い手掛かり])が付きます。強い手掛かりは人の文書にほとんど出ず生成文書に偏って出る指摘、弱い手掛かりは人の文書にも同じくらいかそれ以上に出る指摘です。文章が生成された確率や直す必要の大きさは表さないので、直す優先度は重大度(重大・警告・情報)で決めてください。JSON の signal と改稿指示のルールの見出しにも出ます(出力形式)。
改稿指示を AI や編集者に渡すなら --report brief を使います。JSON・TOON でも出せます。
noslop check README.md --report brief
noslop check README.md --report brief --format toon
改稿後は、指摘の変化に加えて、数字や固有名詞の消失と、文書全体に一律に当てた直しを確認できます。主語や連絡・依頼の相手として足した人や担当(担当者・管理者・私たちなど)も確かめられます。 辞書があれば、品詞が固有名詞の語を長さにかかわらず拾います。辞書なしでは、数字・日付・英字の語・4文字以上のカタカナ語・「」『』で囲んだ語・URLを比べます。辞書が拾わない名前もあるので、結果が空でも情報がすべて残っているとは限りません。
noslop diff draft-v1.md draft-v2.md
noslop explain R01
既定では指摘があっても終了コードは 0 です。指摘で CI を止める場合だけ --fail-on warning などを付けます。引数・設定・入出力の誤りは終了コード 2 です。フックの終了コードは呼び出す側の約束に合わせています。
| 調べたいこと | 文書 |
|---|---|
| 全コマンド・オプション・終了コード | CLI リファレンス |
| ルールの ID・レーン・手掛かりの強さ | ルール一覧・各ルールの説明 |
| コードの対応言語・コメントと静的な文言の取り出し方 | コードのコメントと静的な文言 |
| text・JSON・TOON・GitHub 注釈・改稿指示の例 | 出力形式 |
| CI に組み込む例 | GitHub Actions で使う |
| スキル・MCP・フックの導入 | AI エージェントへの導入・連携の仕様 |
| 改稿の確認事項と、点数を出さない理由 | 改稿の比較と指摘の読み方 |
| 辞書の取得・選択・辞書なしの動作 | 形態素解析の辞書 |
| 校正の根拠と測り直しの手順 | 校正の考え方・校正手順 |
設定
ユーザーの設定は ~/.config/noslop/config.toml、プロジェクトの設定は noslop.toml(または .noslop.toml)に置きます。既定値 → ユーザーの設定 → プロジェクトの設定 → CLI の順に、書いた項目を上書きします。
設定ファイルのひな形は noslop init で作れます。
noslop init --user # ~/.config/noslop/config.toml のひな形を作る (ディレクトリがなければ作る)
noslop init # カレントディレクトリに noslop.toml のひな形を作る
ひな形は項目をすべてコメントにしてあり、そのままでは何も設定しません。項目ごとの説明もコメントで添えてあるので、変えたい項目だけ行頭の # を外して書き換えます。ファイルがすでにあるときは上書きせずに止まります。上書きするには --force を付けます。
ジャンルと辞書を指定するなら、次のように書きます。
genre = "tech"
[morphology]
dictionary = "bundled"
bundled は、品詞で数えるルールを元の校正と同じ同梱の IPAdic で判定する指定です。既定の auto は、取得済みの配布辞書があればそちらを先に選びます。
重ね方・独自ルール・抑制コメント・ジャンルは 設定と抑制コメント に、全項目は 設定の例 にあります。
ライブラリとして使う
Markdown・テキストの検査と改稿前後の比較だけを使う場合は、既定の feature を外します。tree-sitter・CLI・フック・シェル連携・辞書の取得処理を依存に含めないので、別の tree-sitter を使うアプリにも組み込めます。
[dependencies]
noslop = { git = "https://github.com/owayo/noslop", default-features = false }
use noslop::{Document, engine::{Engine, EngineOptions}};
let engine = Engine::new(EngineOptions::default())?;
let before = engine.lint(Document::markdown("<p>料金は100円です。</p>"));
let after = engine.lint(Document::plain_text("料金は200円です。"));
let comparison = noslop::diff::compare(&engine, before, after)?;
Markdown 内の HTML 本文も検査し、見出し・リスト・表・引用と原文の位置を保ちます。辞書は同梱しません。辞書がなければ近似で判定し、手元の辞書を使う場合は EngineOptions::morphology で指定します。
| feature | 有効になる機能 |
|---|---|
code |
コードのコメント・静的な文言の検査(全言語の tree-sitter 文法) |
dictionary-download |
配布辞書の取得・検証・一覧 |
cli |
CLI・MCP・フック・シェル連携・レビュー。code と dictionary-download も有効にする |
bundled-dict |
準備済みの辞書を同梱する。ソースからビルドする前に make dict-bundled が必要 |
既定は cli と bundled-dict で、配布する CLI の機能はすべて有効です。ライブラリでも features = ["code"] などで必要な機能を加えられます。入力形式は feature にかかわらず同じです。code を外してコードを指定すると、Document::try_parse・Engine::try_lint_source・Engine::run は誤りを返します。Document::parse と Engine::lint_source は、未対応の形式を指定すると panic するため、形式が実行時に決まる場合は try_ の API を使ってください。
開発
mise が必要です。ツールの版は mise.toml で固定しています。
make setup # ツールチェーン (mise)・依存・同梱辞書を取得する
make ci # CI と同じ検査 (書き換えない)
| コマンド | 説明 |
|---|---|
make setup |
ツールチェーン (mise)・依存・同梱辞書を取得する |
make build |
デバッグ版をビルドする |
make release |
リリース版をビルドする |
make run |
デバッグ版を実行する (引数は ARGS="...") |
make test |
テストを実行する |
make test-no-default-features |
文書用ライブラリだけでテストする (--no-default-features) |
make test-no-bundled-dict |
辞書を同梱しない CLI でテストする |
make test-library |
ライブラリの feature ごとに clippy とテストを実行する |
make test-embedding |
別の tree-sitter を使うアプリへの組み込みを確かめる |
make lint |
clippy を警告ゼロで通す |
make fmt |
コードを整形する (書き換える) |
make fmt-check |
整形済みかを確かめる (書き換えない) |
make check |
整形と静的検査 (書き換えない) |
make ci |
CI と同じ検査 (書き換えない) |
make install |
リリース版を INSTALL_PATH (既定 /usr/local/bin) に入れる |
make uninstall |
INSTALL_PATH から取り除く |
make clean |
ビルド成果物を消す |
make dict-bundled |
固定情報に合う同梱辞書を準備する (取得済みなら照合だけ) |
make dict-bundled-update |
同梱辞書の固定情報と表示を、依存の hasami のリリースに更新する |
make hasami-update |
依存の hasami を TAG の版 (省くと最新のリリース) に上げ、同梱の辞書も同じリリースにそろえる |
make でターゲットの一覧を表示します。リリースは GitHub Actions で行います (Actions → Release → Run workflow)。
語句照合の性能測定を含む開発手順と、リリースの仕組み・ロードマップは 開発とリリース を参照してください。
ライセンス
noslop のルール体系・語句カタログ・閾値の一部は、MIT ライセンスで公開されている日本語の文章作法プロジェクトに由来します。著作権表示とライセンス全文は THIRD_PARTY_NOTICES.md にあります。
文分割には、日本語の形態素解析器 hasami(MIT)の辞書を使わない文分割を使っています。hasami が組み込む例外表(文末記号を含む語の一覧)は、SudachiDict などの辞書データから抽出しています。出典と著作権表示は THIRD_PARTY_NOTICES.md にあります。
既定のバイナリ(feature bundled-dict)には、hasami が mecab-ipadic から作った形態素解析の辞書を同梱しています。mecab-ipadic のライセンス(NAIST-2003)の条文は THIRD_PARTY_NOTICES.md に、辞書の出所は dict/README.md にあります。
noslop MCP questions
What does noslop actually do?
It identifies stylistic patterns common in LLM-generated Japanese text, such as repetitive sentence structures, specific fixed phrases, and monotonous rhythms, in documents and code comments.
Does it determine if a text was written by an AI?
No, it is not a tool for determining if a text was written by an AI; instead, it points out suspicious parts so the writer can decide whether to revise them based on context.
How does it handle code files?
It uses tree-sitter to extract and inspect comments, static Japanese strings, and JSX/HTML content within various programming languages.