关于 プロジェクトディレクトリ概要
该项目通过 MCP 服务提供 Gemini、Anthropic 文档及 OpenAPI 文档,适用于需要在客户端中查阅 API 资料的开发者。它包含文档爬取脚本,并可从本地 JSON 或 YAML 文件读取内容。
主要功能
- 01提供 Gemini 和 Anthropic 文档
- 02读取 OpenAPI YAML 文件
- 03爬取网页并保存文档
- 04配置预设或自定义爬取规则
适用场景
- 01在 Claude 中查阅 Gemini API 文档
- 02在 Claude 中查阅 Anthropic API 文档
- 03通过本地 YAML 查阅 OpenAPI 文档
- 04按路径和页面上限抓取文档网站
MCP 相关
项目包含多个 MCP 服务程序,可将本地 JSON 文档或 OpenAPI YAML 内容提供给 Claude 等客户端。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
来自项目 READMEプロジェクトディレクトリ概要
このプロジェクトは、MCP サーバーを使用して API ドキュメントを参照する方法を提供します。reference の機能を使用して実装されています。
ディレクトリ構成
README.md: このファイル。プロジェクトの概要と使用方法を記載しています。crawl_all.py: 特定のウェブページをクロールするスクリプト。(使用方法は後述)document/: クローリングした結果が保存されるディレクトリ。gemini_docs.py:gemini_docs.jsonの内容を MCP サーバー経由で提供するメインプログラム。anthropic_docs.py:anthropic_docs.jsonの内容を MCP サーバー経由で提供するメインプログラム。openapi_docs.py:openapi.yamlの内容を MCP サーバー経由で提供するメインプログラム。
使用方法
詳細なセットアップ手順については、公式クイックスタートガイドを参照してください。事前に本リポジトリをクローンしてください。
-
ドキュメントの用意 document の中身は本リポジトリには含めておりません。各自クローリングして document 内に保存してください。詳しい方法については本 readme 末尾に記載があります。
-
uv のインストール
curl -LsSf https://astral.sh/uv/install.sh | sh
- 仮想環境の有効化
uv venv
source .venv/bin/activate
- 依存関係のインストール
uv add "mcp[cli]" PyYAML
- プログラムの動作確認
例として、gemini_docs.py を実行します。
uv run gemini_docs.py
claude_desktop_config.jsonの更新
以下の設定を追加または更新してください。
{
"mcpServers": {
"gemini_docs_resource": {
"command": "uv",
"args": [
"--directory",
"mcp_server ディレクトリへのパス",
"run",
"gemini_docs.py"
]
}
}
}
注: 実行がうまくいかない場合は、uv を絶対パスに変更してください。また、必要に応じて gemini_docs.py を anthropic_docs.py または openapi_docs.py に変更してください。
- Claude の再起動
設定を反映させるために Claude を再起動してください。
各 MCP サーバーについて
- gemini_docs.py: クローリング結果が JSON ファイルとして保存され、その内容を利用します。
- anthropic_docs.py: クローリング結果が JSON ファイルとして保存され、その内容を利用します。
- openapi_docs.py: OpenAPI ドキュメントはクローリングできないため、GitHub リポジトリからダウンロードしたファイルを参照します。このプログラムは YAML 形式のファイルを読み取るように設計されています。
クローリング
crawl_all.py を使用して、プリセットに基づき gemini と anthropic のドキュメントをクロールできます。
python crawl_all.py --preset gemini
python crawl_all.py --preset anthropic
また、プリセットを使用せず、任意の設定でクロールすることも可能です。
python crawl_all.py \
--base-url "https://example.com" \
--start-path "/docs" \
--output_file "document/example_docs.json" \
--selector "main" \
--path-pattern "^/docs/.*" \
--delay 0.5 \
--max-pages 100
主なコマンドラインオプション
| オプション | 説明 |
|---|---|
--preset | gemini または anthropic を指定すると、事前定義された設定でクロールを開始します。 |
--base-url | クロール対象サイトのベース URL(例: https://example.com)。 |
--start-path | クロール開始パス(例: /docs)。 |
--output_file | クロール結果の保存先ファイルパス(例: document/example_docs.json)。 |
--selector | ページ内でコンテンツを取得するための CSS セレクタ(デフォルト: main)。 |
--delay | 各リクエスト間の待機時間(秒)(デフォルト: 0.5 秒)。 |
--use-selenium | 動的ページ対応のため Selenium を使用する場合に指定します。 |
--wait-time | Selenium 使用時のページ読み込み待機時間(秒)(デフォルト: 5 秒)。 |
--additional-paths | クロール対象に追加するパスのリスト。 |
--path-pattern | クロール対象とする URL パスの正規表現パターン。 |
--max-pages | 最大クロールページ数(例: 200 ページまで)。 |
--debug | デバッグモードを有効にして詳細なログを出力します。 |
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。