ecosystems-packages MCP 服务器

关键词

包信息查询本地数据库API 回退JSON-RPC版本与公告

使用说明（Markdown 格式如下，包含项目简介、主要功能、安装步骤、服务器配置与基本使用方法）

  • 项目简介 该仓库实现了一个 MCP 服务器，专注于查询包生态数据。它为 LLM 客户端暴露一组可调用的工具（Tools），例如获取包信息、查找包、获取版本、获取安全公告、获取仓库信息、查询依赖关系以及跨生态的包搜索等。服务器在本地存在可用的数据库时使用本地数据，若本地数据库不可用则通过远端 API 进行数据查询；并提供健康检查等管理工具，便于监控和集成。

  • 主要功能点

    • 提供一组可被 LLM 调用的工具（Tools），如：
      • get_package、lookup_package、get_package_versions、get_package_advisories、get_package_repository、get_package_dependents、search_packages、list_registries、get_database_info、health_check 等
    • 支持本地数据库优先策略，若无本地数据库则改为 API 回退
    • 通过 JSON-RPC 接口处理工具查询请求，返回结构化文本或 JSON 数据
    • 通过 stdio 传输与客户端进行通信，方便在多种环境中嵌入

  • 安装步骤

    • 使用全局安装并运行：
      • 安装方式：npm install -g @ecosyste-ms/mcp
      • 运行方式：npx @ecosyste-ms/mcp
    • 该服务器会尝试使用本地数据库（如 bundled 的 critical 数据库），若你有自定义数据库，请将数据库路径通过 ECOSYSTEMS_DB_PATH 指定，或将 critical-packages.db 放在工作目录，服务器会优先使用该数据库。

  • 服务器配置（配置信息以 json 形式给出，包含 server name、command、args 等，注释用自然语言描述以帮助理解；MCP 客户端通常不需要你提供此信息，只用于开发和集成时的参考） { // 服务器名称，便于区分多个 MCP 服务 "server_name": "ecosystems-packages", // 启动命令，客户端需要知道如何启动该服务器 "command": "npx", // 启动参数，通常为直接执行该 MCP 包 "args": ["@ecosyste-ms/mcp"], // 可选的环境变量，若你有自定义数据库路径，请设置 ECOSYSTEMS_DB_PATH "env": { // "ECOSYSTEMS_DB_PATH": "/path/to/your/critical-packages.db" }, // 备注 "notes": "该服务器通过标准输入输出（stdio）与客户端通信，运行时自动加载本地数据库（若存在）或回退到远端 API；如需在 Claude/ChatGPT 等工具中接入，请通过其提供的自建连接方式连接该服务器。" }

  • 基本使用方法

    1. 启动服务器：按照上面的安装步骤，在需要的位置执行 npx @ecosyste-ms/mcp，确保工作目录下可访问必要的数据库文件（如有）。
    2. 在支持工具调用的 LLM 环境中，向服务器发送 JSON-RPC 的 ListTools 请求以获取可用工具列表，再按需调用对应的 CallTool 请求来获取数据或执行操作。
    3. 如需本地数据库，请确保 ECOSYSTEMS_DB_PATH 指向有效的 SQLite 数据库文件；若没有，本地查询将回退到公开 API。
    4. 如需健康检查，请调用 health_check 工具以确认数据库连接和 API 的可用性。

  • 其他说明

    • 默认传输是标准输入输出（stdio），便于集成到现有的开发环境和脚本中。
    • 服务器实现了错误处理，能够将错误信息以结构化形式返回给客户端，便于诊断和重试。

服务器信息

访问项目