MCP Schema Audit

mcp-schema-audit-mcp

ほかの MCP ツール定義やマーケットプレイスの掲載情報を監査し、モデルがツールを誤って呼び出したり、まったく呼び出さなかったり、パラメーターを誤って入力したりする原因となる具体的なパターンを検出する MCP サーバーです。曖昧な説明、パラメーターの説明不足、動詞から始まらない命名、巨大な列挙型、深くネストしたスキーマに加え、MCPize の説明文に設けられた500文字の上限も検出します。この上限に違反すると、デプロイ時に警告なしで失敗します。

ツール定義の問題の多くはエラーを発生させません。モデルが誤ったツールを呼び出したり、適切なツールを誤った引数で呼び出したりするだけで、しかもそれは気づきにくく、断続的に発生します。すべてのツールを0〜100点で評価し、修正すべき箇所を具体的に示します。

このツールが作られた理由

動詞から始まる命名、パラメーターの説明、スキーマの深さは、見た目だけの問題ではありません。これらは、モデルがツールをどれだけ確実に選び、パラメーターを正しく入力するかに、測定可能な影響を与えます。このプロジェクトでは、ツールを新しく作るたびに読み返す必要のあるブログ記事ではなく、実際の監査ツールとしてこれらのパターンを実装しています。

ツール

audit_tool_definition

単一のツール（名前、説明、inputSchema）を監査します。使いやすさのスコアを0〜100で返し、各問題の重大度、重要な理由、修正方法を具体的に示します。

audit_tool_batch

サーバー内のすべてのツールを対象に同じチェックを実行し、さらにツール間のチェックも行います。重複した名前、命名規則の不統一（1つのサーバー内でsnake_caseとcamelCaseが混在している場合）、問題が最も多い項目の要約を確認します。

check_marketplace_description

マーケットプレイス向けの短い説明文と長い説明文が、既知のプラットフォーム制限に適合しているかを検証します。特に、デプロイを試してから気づくことのないよう、MCPize の短い説明文に対する500文字の上限を事前に検出します。

使い方

ホステッド版（推奨、セットアップ不要）： MCPize に登録してください。無料プランが含まれています。より多く利用する場合は月額7ドルです。

セルフホスト：

npm install
node server.js

:8080（/mcp）でStreamable HTTP MCPエンドポイントを公開し、/healthでヘルスチェックを提供します。

小規模ツール群の一部

Claude Code／MCP ビルダー向けの、正確性監査ツール3つとともに開発されました。 cron-schedule-audit-mcp（DSTを考慮したcronの検証）、regex-safety-audit-mcp（ReDoSの検出）、claude-cost-audit-mcp（Claude APIの正確なコストとキャッシュの費用対効果を計算）。

ライセンス

MIT