MCP

🚀 @ecosyste - ms/mcp

MCP 服务器用于从 ecosyste.ms 查询软件包生态系统数据。它会查询本地关键软件包的 SQLite 数据库以实现快速查找，对于数据库中没有的软件包则会通过 API 进行查询。

🚀 快速开始

MCP 服务器可用于查询软件包生态系统数据，通过本地 SQLite 数据库实现快速查找，数据库中没有的软件包则通过 API 进行查询。

📦 安装指南

你可以使用以下两种方式安装 @ecosyste - ms/mcp：

使用 npm 全局安装

npm install -g @ecosyste-ms/mcp

使用 npx 直接运行

npx @ecosyste-ms/mcp

数据库通过 @ecosyste - ms/critical 进行打包，无需额外设置。若要使用自定义数据库，可设置 ECOSYSTEMS_DB_PATH 环境变量，或者将 critical - packages.db 文件放在工作目录中。

💻 使用示例

与 LLM 工具结合使用

Claude Code

在终端中运行以下命令：

claude mcp add ecosystems -- npx @ecosyste-ms/mcp

若要使用自定义数据库路径，可以这样运行：

claude mcp add ecosystems -- env ECOSYSTEMS_DB_PATH=/path/to/db.sqlite npx @ecosyste-ms/mcp

在 Claude Code 中，使用 /mcp 命令来验证服务器是否正在运行。

Claude Desktop

在 macOS 系统中，将以下配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中；在 Windows 系统中，添加到 %APPDATA%\Claude\claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "ecosystems": {
      "command": "npx",
      "args": ["@ecosyste-ms/mcp"]
    }
  }
}

若要使用自定义数据库路径：

{
  "mcpServers": {
    "ecosystems": {
      "command": "npx",
      "args": ["@ecosyste-ms/mcp"],
      "env": {
        "ECOSYSTEMS_DB_PATH": "/path/to/critical-packages.db"
      }
    }
  }
}

Cursor

将以下配置添加到项目的 .cursor/mcp.json 文件中，或者全局添加到 ~/.cursor/mcp.json 文件中：

{
  "mcpServers": {
    "ecosystems": {
      "command": "npx",
      "args": ["@ecosyste-ms/mcp"]
    }
  }
}

VS Code

在终端中运行以下命令：

code --add-mcp '{"type":"stdio","name":"ecosystems","command":"npx","args":["@ecosyste-ms/mcp"]}'

或者手动将以下配置添加到 .vscode/mcp.json 文件中：

{
  "servers": {
    "ecosystems": {
      "type": "stdio",
      "command": "npx",
      "args": ["@ecosyste-ms/mcp"]
    }
  }
}

然后在 VS Code 中打开 .vscode/mcp.json 文件，点击 “Start server” 启动服务器。

Windsurf

将以下配置添加到 ~/.codeium/windsurf/mcp_config.json 文件中：

{
  "mcpServers": {
    "ecosystems": {
      "command": "npx",
      "args": ["@ecosyste-ms/mcp"]
    }
  }
}

Zed

在 Zed 设置（cmd + ,）中添加以下配置：

{
  "context_servers": {
    "ecosystems": {
      "command": {
        "path": "npx",
        "args": ["@ecosyste-ms/mcp"]
      }
    }
  }
}

ChatGPT

注意：ChatGPT 需要远程 MCP 服务器，你需要使用隧道运行服务器或进行部署。 对于使用隧道进行本地开发的情况，可运行以下命令：

npx @anthropic-ai/mcp-proxy --port 8080 -- npx @ecosyste-ms/mcp

然后在 ChatGPT 中：

• 导航到 Settings > Connectors
• 添加一个自定义连接器，使用你的隧道 URL
• 服务器将在 Composer > Deep Research 中可用

Codex

将以下配置添加到 ~/.codex/config.toml 文件中：

[mcp_servers.ecosystems]
command = "npx"
args = ["@ecosyste-ms/mcp"]

Gemini CLI

将以下配置添加到 ~/.gemini/settings.json 文件中：

{
  "mcpServers": {
    "ecosystems": {
      "command": "npx",
      "args": ["@ecosyste-ms/mcp"]
    }
  }
}

可用工具

软件包工具

• get_package - 根据生态系统和名称获取完整的软件包数据
• lookup_package - 通过 PURL、生态系统 + 名称或仓库 URL 查找软件包
• get_package_versions - 获取所有版本及其发布日期
• get_package_advisories - 获取安全建议（CVEs）
• get_package_repository - 获取仓库元数据（星标数、分支数、语言）
• get_package_dependents - 获取依赖此软件包的软件包
• search_packages - 全文搜索（需要本地数据库）

注册表工具

• list_registries - 列出所有可用的软件包注册表
• get_database_info - 获取本地数据库统计信息
• health_check - 检查服务器健康状况（数据库连接性、API 可用性）

示例

你可以向你的大语言模型询问以下问题：

• "lodash 使用什么许可证？"
• "展示 express 的 CVEs"
• "react 仓库有多少个星标？"
• "哪些软件包依赖 typescript？"
• "搜索与身份验证相关的软件包"
• "axios 的最新版本是什么？"

📚 详细文档

支持的生态系统

npm、pypi、rubygems、cargo、go、maven、nuget、packagist、hex、pub、hackage、cocoapods、conda、clojars、puppet、homebrew、docker、bower、cpan、cran、julia、swiftpm、elm、deno、alpine、actions、openvsx、spack、adelie、vcpkg、racket、bioconductor、carthage、postmarketos、elpa

开发

克隆仓库并安装依赖：

git clone https://github.com/ecosyste-ms/mcp
cd mcp
npm install
npm test

在本地运行：

node index.js

📄 许可证

本项目采用 MIT 许可证。