FixYourDocs

@fixyourdocs/mcp-server

単一のツール、file_doc_feedback を提供する Model Context Protocol（MCP）サーバーです。MCP クライアント（Claude Desktop、Cursor、Codex、Gemini CLI、…）は、壊れている、誤っている、古くなっている、欠けている、不明瞭である、またはその他の理由で役に立たないドキュメントに遭遇した際、構造化されたドキュメントフィードバックレポートを FixYourDocs ハブ（hub.fixyourdocs.io）に送信できます。

ドキュメント所有者が FixYourDocs インテグレーションをインストールしている場合、レポートはそのリポジトリの GitHub Issue に転送されます。ホームへの通信やテレメトリーはありません。エージェントが明示的にツールを呼び出した場合にのみ、サーバーはハブに接続します。

• ドキュメント： docs.fixyourdocs.io/mcp/
• 仕様： Docs Feedback Protocol v0
• SDK： @fixyourdocs/sdk
• Issue／コントリビューション： https://github.com/fixyourdocs/fixyourdocs

インストール

このサーバーは npx 経由で実行するように設計されているため、通常は直接インストールする必要はありません。MCP クライアントが必要に応じて起動します。

npx -y @fixyourdocs/mcp-server

標準の MCP stdio トランスポートを使用します。別のハブを指定する場合を除き、設定は不要です（下記の環境変数を参照）。

クライアントの設定

MCP クライアントごとに独自の設定ファイルがありますが、形式は同じです。command と args を指定した名前付きサーバーエントリを記述します。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "fixyourdocs": {
      "command": "npx",
      "args": ["-y", "@fixyourdocs/mcp-server"]
    }
  }
}

Claude Desktop を再起動します。ツール一覧に file_doc_feedback が表示されます。

Cursor

~/.cursor/mcp.json（またはワークスペースの .cursor/mcp.json）を編集します。

{
  "mcpServers": {
    "fixyourdocs": {
      "command": "npx",
      "args": ["-y", "@fixyourdocs/mcp-server"]
    }
  }
}

Codex／OpenAI Codex CLI

~/.codex/config.toml を編集します。

[mcp_servers.fixyourdocs]
command = "npx"
args = ["-y", "@fixyourdocs/mcp-server"]

mcp-inspector（動作確認用）

npx @modelcontextprotocol/inspector npx -y @fixyourdocs/mcp-server

インスペクターの UI には file_doc_feedback が表示されます。サンプルレポートを入力すると、ハブから返される { id } が表示されます。

ツール：file_doc_feedback

入力

v0 仕様の Report エンベロープに準拠しています。

フィールド	型	必須	備考
doc_url	string	はい	問題が発生したドキュメントページの URL。最大 2048 文字です。
agent.name	string	はい	小文字のケバブケース形式の識別子。例：claude-code、cursor、codex。最大 64 文字です。
agent.version	string	いいえ	任意のエージェントバージョン文字列です。
agent.vendor	string	いいえ	任意のベンダー／パブリッシャー名。例：Anthropic。
report.kind	enum	はい	次のいずれかです：broken、incorrect、outdated、missing、unclear、other。
report.summary	string	はい	1 行の説明です。280 文字以下です。
report.details	string	いいえ	任意の詳細な説明です。8000 文字以下です。
report.suggested_fix	string	いいえ	任意の具体的な提案です。4000 文字以下です。

出力

{
  "id": "01ABCDEF0123456789ABCDEFGH"
}

id はハブから返される ULID です。これは冪等性の確認に使うものであり、取得可能なハンドルではありません。公開 API ではレポートは書き込み専用です。取得用のエンドポイントはなく、レポートの内容がドキュメント所有者に届くのは、ハブによる GitHub Issue への転送を通じてのみです。

動作

• サーバーはハブに接続する前に、入力が v0 の字句制約 （URL の解析、エージェント名のパターン、概要の長さ）に準拠しているかを検証します。検証エラーは、人が読める説明を含む MCP の isError: true 結果として返されます。
• 201 Created（新規送信）または 200 OK（冪等な重複）の場合、ツールはどちらの場合も { id } を返します。エージェントが区別する必要はありません。ハブが課題を二重登録することはありません。
• 429 rate_limited、5xx、またはネットワークエラーが発生した場合、ツールはエラーをそのまま表示します。クライアントは一時的なエラーとして扱い、同じペイロードで再試行してください（ハブは本文の内容に基づいて重複を排除します）。

環境変数

変数	デフォルト	用途
FIXYOURDOCS_HUB_URL	https://hub.fixyourdocs.io	ハブのベース URL を上書きします。テストやセルフホストに便利です。

プライバシー

• テレメトリなし、外部への自動通信なし。 サーバーが外部ネットワークに 接続するのは、エージェントが明示的にツールを呼び出した場合 のみです。分析情報の送信、バージョン確認の ping、診断情報の アップロードは行いません。
• 報告ペイロードに含まれるのは、エージェントが指定したフィールド （ドキュメント URL、エージェントの識別情報、種類、概要、任意の詳細と 修正案）のみです。プロセス環境、ファイルパス、システム識別子は追加されません。

ライセンス

Apache-2.0。詳細は LICENSE を参照してください。