uagents

---

doc2mcp の 3 つの利用方法

利用方法	最適な用途	ここから始める
ウェブ	ブラウザーですぐに変換	doc2mcp.site
CLI	ターミナル + Cursor へのワンショットインストール	npm i -g doc2mcp
SDK	コード、CI、LangChain / LangGraph / エージェント	doc2mcp-sdk

API キーは常に doc2mcp.site（ユーザー PAT + プロジェクトトークン）から取得します。SDK には個別のログインはありません。

---

パイプライン

ドキュメント URL → クロール → 分析 → MCP ツール → ホスト型エンドポイント → Cursor / Claude / LangChain / LangGraph。

---

1) ウェブ（通常）

1. doc2mcp.site/login でサインインします
2. ドキュメント URL を貼り付けます（Stripe、LangChain、Mintlify、GitHub など）
3. ホスト型 MCP URL + Bearer トークンを Cursor / Claude / VS Code にコピーします

{
  "mcpServers": {
    "my-docs": {
      "url": "https://doc2mcp.site/api/mcp/{project_id}/mcp",
      "headers": { "Authorization": "Bearer <project-token>" }
    }
  }
}

---

2) CLI

npm install -g doc2mcp
doc2mcp login                 # creates User PAT (d2mcp_pat_…)
doc2mcp https://docs.example.com

ダッシュボードと同じプロジェクトを一覧表示します。Cursor / VS Code / Claude / Windsurf 用のインストールヘルパーを利用できます。

---

3) SDK（doc2mcp-sdk）

npm i doc2mcp-sdk

import { Doc2MCP } from "doc2mcp-sdk";

// User PAT from doc2mcp.site / `npx doc2mcp login` — SDK has no auth of its own
const client = new Doc2MCP({ token: process.env.DOC2MCP_API_TOKEN! }); // Settings → d2mcp_usr_…

const ready = await client.convertAndWait({
  sourceUrl: "https://js.langchain.com/docs",
});

const answer = await client.callToolText({
  mcpUrl: ready.mcp.url,
  mcpToken: ready.mcp.token, // project token d2mcp_…
  name: "search_documentation",
  arguments: { query: "how do runnables work?" },
});

ハンドブック全文（API キー、Cursor、Claude、LangChain、LangGraph、LangSmith、OpenAI、Vercel AI SDK、CrewAI、AutoGen、Mastra）：

doc2mcp/doc2mcp-sdk → docs/

製品ドキュメントページ：doc2mcp.site/docs/sdk

---

プロジェクトごとに生成される MCP ツール

ツール	機能
list_documentation_pages	クロールしたすべてのページ
get_documentation_page	1 ページ分の完全なマークダウン
search_documentation	見出しを考慮した検索
get_documentation_overview	要約 + インデックス
read_full_documentation	すべてのページを結合した内容
ask_documentation	引用付きの Q&A

リポジトリ

リポジトリ	目的
doc2mcp/doc2mcp （このリポジトリ）	Next.js アプリ、CLI、パイプライン、MCP ランタイム
doc2mcp/doc2mcp-sdk	プログラムから利用できる JS/TS SDK + フレームワークの例
doc2mcp/doc2mcp-registry	MCP Registry ゲートウェイマニフェスト

貢献

1. CONTRIBUTING.md と CODE_OF_CONDUCT.md を読みます
2. staging からブランチを作成 → PR を作成 → staging にマージします
3. AI レビュー（Gemini PR review）では必須修正のチェックに失敗するとマージできません — マージ前にブロッカーを修正してください
4. クーポン opensourcedoc2mcp → 料金で Starter を 12 か月間無料で利用できます

詳細：doc2mcp.site/open-source

ローカル開発

pnpm install
cp .env.example .env.local
pnpm dev

pnpm check
pnpm exec tsc --noEmit --skipLibCheck

CI / CD

Feature → staging（プレビュー）→ main → v* タグで Vercel に本番環境をデプロイします。

PR チェック：Biome/Ultracite、TypeScript、Next のビルド、CLI のビルド、Gemini AI によるレビュー（必須修正項目がある場合 → チェック失敗）

ライセンス

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