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 許可證。