Vellum

生成されたドキュメント（.docx、.pdf）がユーザーに届く前に検査する MCP サーバーです。構造、タイポグラフィ、スペーシング、言語の正確さに関する、確かで測定可能な事実を抽出し、AI アシスタントが自身のフォーマットミスをそのまま出荷する代わりに検出できるようにします。

2026-07-28 MCP 仕様に基づいて構築されています。設計根拠の詳細は docs/architecture.md を参照してください。

なぜ

ドキュメント生成スキルは .docx/.pptx/.pdf 出力を生成しますが、結果が正しく構成されているかを自動的に検証するものはありません。見出しレベルがスキップされたり、フォントが一貫しなかったり、スペーシングがずれたり、文法エラーが黙って通過したりします。Vellum は生成器ではなく、検証レイヤーです。

Related MCP server: mcp-server-docx

基本原則

サーバーは事実を抽出します。モデルが判断を下します。

Vellum は「これは間違っている」とは決して言いません。「これが実際に真実であること、そしてこれがドキュメントの残りの部分と比較して統計的に異常であること」を伝えます。特定の値がドキュメント内での行の役割（タイトル vs キャプション vs 本文）に対して適切かどうかの判断は、ドキュメントの完全なコンテキストを持つ呼び出し元モデルに委ねられる意味的判断です。サーバーはその判断を持たず、持とうとすべきでもありません。

ツール

すべてのツールは、構造化された事実と異常フラグを返します — 判定を返すことは決してありません。

すべてのツールは、ドキュメントをファイルシステムの path またはインラインの content_base64（filename の併記必須）として受け取ります。これは、ドキュメントが最初にディスクに保存されるのではなく、会話内にのみ存在する場合（例: チャットインターフェースに直接アップロードされた場合）に便利です。2つの入力形式のうち、正確に1つだけを指定する必要があります。

ステータス

6つのツールすべて（check_docx_structure、check_docx_typography、check_pdf_layout、check_language、check_filename_consistency、full_report）は完全に実装され、ユニットテストされ、既知の人為的欠陥を持つゴールデンセットのフィクスチャに対して検証されています。MCP の全サーフェス（リソース、プロンプト、エリシテーション、キャッシュヒント、HTTP トランスポート用の OAuth 2.1 リソースサーバー認証、正しいエラーセマンティクス）は構築・テスト済みです（163以上のテストが成功）。詳細な構築履歴と現在の未解決項目については、docs/architecture.md と PROGRESS.md を参照してください。パッケージ化/公開（Phase 7）は進行中です — まだ PyPI にはリリースされていません。

インストール

git clone https://github.com/Nasser9892/vellum-mcp.git
cd vellum-mcp
pip install -e ".[dev]"

check_language を使用するには、ローカルの LanguageTool インスタンスが必要です。セットアップについては docs/architecture.md を参照してください。

使用方法（Claude Desktop / 任意の MCP stdio クライアント）

MCP クライアント設定に追加してください（examples/claude_desktop_config.json を参照）：

{
  "mcpServers": {
    "vellum": {
      "command": "vellum-mcp"
    }
  }
}

開発

pip install -e ".[dev]"
pytest                          # unit + integration tests
mcp dev src/vellum_mcp/server.py  # run under MCP Inspector

ゴールデンセットのフィクスチャ（意図的に埋め込まれた欠陥を持つサンプル .docx/.pdf ファイル）は golden_set/ にあります。すべてのチェックは、信頼される前にこれらに対して検証されます。その方法論については docs/architecture.md を参照してください。

MCP Inspector（mcp dev src/vellum_mcp/server.py）に対して検証され、実際の MCP クライアント2つ（Claude Desktop（examples/claude_desktop_config.json）と Cursor（~/.cursor/mcp.json、同じ {"mcpServers": {"vellum": {"command": "vellum-mcp"}}} 形状））に対してテストされています。

仕様準拠

• すべてのプリミティブ: ツール、リソース、プロンプト（ツールのみではない）

• ステートレスなコア — Mcp-Session-Id に依存しない

• MRTR によるエリシテーション（InputRequiredResult / inputRequests / inputResponses）

• HTTP トランスポートにおける OAuth 2.1 リソースサーバー姿勢（RFC 9728、RFC 8707、RFC 9207; 非推奨の DCR を介した CIMD）

• 長時間実行分析のための Tasks 拡張（io.modelcontextprotocol/tasks）

• 正しいエラーコード（not-found には -32602、ヘッダー関連の違反には -32020）

• 非推奨の roots/sampling/logging プリミティブを使用しない

ライセンス

MIT — LICENSE を参照してください。