mcpField
プ
プロジェクトディレクトリ概要

プロジェクトディレクトリ概要

本地服务
github.com/yhanawa开发工具076 周前更新

关于 プロジェクトディレクトリ概要

该项目通过 MCP 服务提供 Gemini、Anthropic 文档及 OpenAPI 文档,适用于需要在客户端中查阅 API 资料的开发者。它包含文档爬取脚本,并可从本地 JSON 或 YAML 文件读取内容。

主要功能

  1. 01提供 Gemini 和 Anthropic 文档
  2. 02读取 OpenAPI YAML 文件
  3. 03爬取网页并保存文档
  4. 04配置预设或自定义爬取规则

适用场景

  1. 01在 Claude 中查阅 Gemini API 文档
  2. 02在 Claude 中查阅 Anthropic API 文档
  3. 03通过本地 YAML 查阅 OpenAPI 文档
  4. 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 サーバー経由で提供するメインプログラム。

使用方法

詳細なセットアップ手順については、公式クイックスタートガイドを参照してください。事前に本リポジトリをクローンしてください。

  1. ドキュメントの用意 document の中身は本リポジトリには含めておりません。各自クローリングして document 内に保存してください。詳しい方法については本 readme 末尾に記載があります。

  2. uv のインストール

curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 仮想環境の有効化
uv venv
source .venv/bin/activate
  1. 依存関係のインストール
uv add "mcp[cli]" PyYAML
  1. プログラムの動作確認

例として、gemini_docs.py を実行します。

uv run gemini_docs.py
  1. 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 に変更してください。

  1. 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
主なコマンドラインオプション
オプション説明
--presetgemini または 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-timeSelenium 使用時のページ読み込み待機時間(秒)(デフォルト: 5 秒)。
--additional-pathsクロール対象に追加するパスのリスト。
--path-patternクロール対象とする URL パスの正規表現パターン。
--max-pages最大クロールページ数(例: 200 ページまで)。
--debugデバッグモードを有効にして詳細なログを出力します。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。