返回 MCP 目录
public公开dns本地运行

securechain-mcp-server

Secure Chain MCP服务器是一个提供软件供应链安全检查工具的服务,支持Docker部署,集成多种数据库和API,用于监控和分析软件依赖关系与漏洞。

article

README

🚀 Secure Chain MCP Server

Secure Chain MCP Server 是一个 MCP 服务器,它提供了在 Secure Chain 环境中检查软件供应链状态的工具。

🚀 快速开始

开发要求

  1. 使用 Docker 来部署工具。
  2. 使用 Docker Compose 进行容器编排。
  3. 建议使用诸如 MongoDB Compass 之类的图形用户界面(GUI)。
  4. 当容器运行时,用于可视化从数据构建的图的 Neo4J 浏览器界面位于 localhost:7474
  5. Python 3.13 或更高版本。

使用 Docker 部署

1. 克隆仓库

从官方 GitHub 仓库克隆项目:

git clone https://github.com/securechaindev/securechain-mcp-server.git
cd securechain-mcp-server

2. 配置环境变量

.env.example 文件创建一个 .env.local 文件,并将其放置在根目录中。

获取 API 密钥
  • 了解如何获取 GitHub API 密钥
  • 使用你自己的密钥修改 JSON Web Token (JWT) 密钥和算法。你可以使用命令 openssl rand -base64 32 生成自己的密钥。

3. 创建 Docker 网络

确保你已经创建了 securechain Docker 网络。如果没有,请使用以下命令创建:

docker network create securechain

4. 数据库容器

对于图和漏洞信息,你需要从 Zenodo 下载压缩的 数据转储。解压转储文件后,在根文件夹内运行以下命令:

docker compose up --build

容器化的数据库也将自动进行数据填充。

5. 启动应用程序

从项目根目录运行以下命令:

docker compose -f dev/docker-compose.yml up --build

6. 在 Secure Chain 本地部署中创建用户

访问 此处 创建一个用户,例如:

{
  "email": "mcp-bot@example.com",
  "password": "supersecre3T*"
}

7. 使用 VSCode 配置 MCP

.vscode/ 文件夹内添加 mcp.json 文件,内容如下:

{
  "servers": {
    "Secure Chain": {
      "type": "http",
      "url": "http://localhost:8005/mcp",
      "headers": {
        "X-Auth-Email": "mcp-bot@example.com",
        "X-Auth-Pass": "supersecre3T*"
      }
    }
  }
}

然后启动 MCP 服务器,并开始使用它,例如与 Copilot 一起使用。

Python 环境

项目使用 Python 3.13,依赖项列在 requirements.txt 中。

设置开发环境

  1. 创建虚拟环境
python3.13 -m venv depex-env
  1. 激活虚拟环境
source depex-env/bin/activate
  1. 安装依赖项
pip install -r requirements.txt

🤝 贡献代码

欢迎提交拉取请求!对于重大更改,请先打开一个问题,讨论你想要做出的更改。

📄 许可证

GNU 通用公共许可证 3.0

🔗 链接

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端