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

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

site icon
2025.04.21 0
PythonAPI文档管理开发工具开发效率
该项目是一个基于MCP服务器的API文档参考工具,提供多种API文档的访问和管理功能。核心功能包括通过MCP服务器提供Gemini、Anthropic和OpenAPI的文档内容,以及支持网页爬取功能来获取和更新文档内容。适用于需要集中管理和访问多种API文档的开发场景。
View on GitHub

Overview

基本能力

产品定位

MCP服务器用于集中管理和提供多种API文档的访问服务,支持通过爬取或直接读取文件的方式获取文档内容。

核心功能

  1. 文档提供:通过MCP服务器提供Gemini、Anthropic和OpenAPI的文档内容。
  2. 爬取功能:支持通过爬取工具获取Gemini和Anthropic的文档内容并保存为JSON文件。
  3. 文件读取:支持直接读取OpenAPI的YAML文件内容。

适用场景

  1. 开发过程中需要集中访问和管理多种API文档的场景。
  2. 需要定期更新API文档内容的开发团队。
  3. 需要自动化获取和存储API文档的项目。

工具列表

  1. crawl_all.py:用于爬取Gemini和Anthropic的文档内容。
  2. gemini_docs.py:通过MCP服务器提供Gemini文档内容。
  3. anthropic_docs.py:通过MCP服务器提供Anthropic文档内容。
  4. openapi_docs.py:通过MCP服务器提供OpenAPI文档内容。

常见问题解答

  1. 运行失败:确保使用绝对路径运行uv工具,并根据需要更换脚本名称。
  2. 配置更新:更新claude_desktop_config.json文件后需要重启Claude以生效。

使用教程

使用依赖

  1. 安装uv工具:
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 激活虚拟环境:
uv venv
source .venv/bin/activate
  1. 安装依赖:
uv add "mcp[cli]" PyYAML

安装教程

  1. 运行示例脚本:
uv run gemini_docs.py
  1. 更新配置文件claude_desktop_config.json
{
  "mcpServers": {
    "gemini_docs_resource": {
      "command": "uv",
      "args": [
        "--directory",
        "mcp_server ディレクトリへのパス",
        "run",
        "gemini_docs.py"
      ]
    }
  }
}
  1. 重启Claude以应用配置。

调试方式

  1. 爬取文档内容:
python crawl_all.py --preset gemini
python crawl_all.py --preset anthropic
  1. 检查日志和配置文件是否正确。

许可证

该项目遵循 None 开源许可条款。