Fonto Docs

fonto-docs-mcp

Claude Code、Cursor、Claude Desktop などの AI ツールからFonto XML ドキュメントにアクセスできるようにする MCP サーバーです。fonto-docs.elliat.nlで公開中です。

Fonto のドキュメントは JavaScript の SPA でレンダリングされるため、AI が直接読み取ることはできません。このサーバーは、基となる XML を取得し、必要に応じて読みやすく整えた Markdown に変換します。

MCP とは？

MCP（Model Context Protocol）は、AI アシスタントに外部ツールへのアクセスを提供する標準的な方法です。このサーバーを AI ツールに接続すると、以下のツールとリソースにアクセスできるようになります。

ツール	内容
search_fonto_docs	キーワードで検索し、タイトル、説明、スラッグを含む一致したページを返します
get_fonto_page	スラッグを指定して、ページの全文を取得します
lookup_api	API 名（例：documentsManager、createIconWidget）を、1 回の呼び出しで該当ページに直接解決します
list_pages	キーワードに一致するすべてのページを、セクション階層全体とともに一覧表示します。ページの探索に便利です

リソース	内容
fonto://catalog	実際のタイトル、製品ごとのグループ、親子関係のパスを含む約 2000 ページすべて
fonto://page/{slug}	リソーステンプレート。スラッグを指定して任意のページに直接アクセスできます

たとえば、*「addDocumentChangeCallback はどのように動作しますか？」*と尋ねると、AI が公開中の Fonto ドキュメントを検索します。

AI ツールへの接続

サーバーはすでに https://fonto-docs.elliat.nl/mcp で稼働しています。お使いのツールから接続するだけです。

Claude Code（CLI）

claude mcp add --transport http fonto-docs https://fonto-docs.elliat.nl/mcp

Cursor

プロジェクトの .cursor/mcp.json（またはグローバル設定の ~/.cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "fonto-docs": {
      "type": "http",
      "url": "https://fonto-docs.elliat.nl/mcp"
    }
  }
}

Claude Desktop / claude.ai

カスタムコネクターとして追加します。Customize → Connectors に移動して + → Add custom connector をクリックし、https://fonto-docs.elliat.nl/mcp を貼り付けます。OAuth の設定は不要です。この方法で追加したコネクターは、Claude Desktop と claude.ai の両方で利用できます。リモート MCP を使用したカスタムコネクターの始め方をご覧ください。

（claude_desktop_config.json はローカルの stdio サーバーのみを起動するため、このサーバーには使用できません。）

Mistral AI / Vibe

最も簡単な方法は、Mistral コンソールの Connectors ページから接続することです。

1. Connectors ページに移動し、+ Add Connector をクリックします。
2. Custom MCP Connector タブを開きます。
3. 名前（例：fonto-docs）とサーバー URL https://fonto-docs.elliat.nl/mcp を入力し、Connect をクリックします。

認証は不要です。Vibe はこの方法で登録されたコネクターを自動的に検出するため、Mistral アカウントでサインインしているすべての Vibe セッションでツールを利用できます。ローカル設定は必要ありません。

または、~/.vibe/config.toml を編集して、ローカルの Vibe 設定にサーバーを追加できます。

[[mcp_servers]]
name = "fonto-docs"
transport = "streamable-http"
url = "https://fonto-docs.elliat.nl/mcp"

サーバーは認証を必要としないため、auth ブロックは不要です。

詳しくはMCP コネクターのドキュメントをご覧ください。

使用例

接続したら、AI アシスタントに次のように尋ねてみてください。

• 「Fonto ドキュメントで documentsManager を検索して」
• 「clearundostackfordocument-f0187fade723 の Fonto ドキュメントページを取得して」
• 「Fonto ドキュメントによると、addDocumentChangeCallback はどのように動作しますか？」
• 「configure セクションのすべてのページを一覧表示して」
• 「どのようなアップグレードガイドがありますか？」

HTTP API

MCP を使わずに利用する場合は、サーバーが通常の HTTP API も公開しています。

• GET /search?q={query} — キーワードでページを検索します
• GET /page/{slug} — ページを Markdown として取得します
• GET /api/{name} — API シンボルのページを正確な名前で Markdown として取得します（該当するものがない場合は候補とともに 404 を返します）
• GET /catalog — セクションごとに分類されたページカタログ全体を取得します。絞り込むには ?section={keyword} を追加します

仕組み

Fonto のドキュメントサイトは、予測可能な /static/xml/ 配下の URL に XML としてコンテンツを保存しています。このサーバーはそれらの XML ファイルを直接取得し、JavaScript によるレンダリングを回避して Markdown に変換します。同じセッションでの繰り返しの検索を抑えるため、ページコンテンツはプロセス内で 10 分間キャッシュされます。その後、get_fonto_page は documentation.fontoxml.com から再び最新データを取得します。list_pages と fonto://catalog が使用するページカタログは、初回使用時に Fonto の検索インデックスから一度だけ取得され、プロセスの存続期間中はメモリに保持されます。

セルフホスト

npm install
npm start        # runs on port 8080 by default
PORT=3000 npm start

コントリビューション

PR を歓迎します。src/fonto.js の XML から Markdown への変換は、次の 2 つの形式に対応しています。

• DITA ガイドページ — <topic>、<body>、<section> 構造
• API リファレンスページ — カスタムの <type>、<members>、<description> 構造

適切に変換されないページがあれば、その slug を添えて issue を作成してください。

ライセンス

MIT