Evernight MCP 服务

简介

Evernight 是一个基于 Spring AI MCP Server WebMVC 的 streamable HTTP MCP 服务。它把 Maven、npm、PyPI 和 OSV 的常用查询封装成结构化 MCP 工具，适合在 vibe coding、依赖升级、漏洞排查和自动化研发工作流中使用。

服务默认暴露：

• MCP endpoint：/mcp
• 工具首页：/
• 当前镜像白名单：/api/repositories
• 健康检查：/actuator/health

公共服务

{
  "mcpServers": {
    "evernight": {
      "url": "https://suhoan-evernight.ms.show/mcp"
    }
  }
}

功能特性

• 支持 Maven、npm、PyPI 包信息查询。
• 支持 OSV 已知漏洞查询。
• Maven、npm、PyPI 镜像地址均通过白名单校验，降低 SSRF 风险。
• 使用 Caffeine 缓存上游查询结果，可按生态配置 TTL。
• 支持 HTTP/HTTPS/SOCKS5 代理访问上游服务。
• 支持按客户端 IP 限流。
• 提供统一错误响应，便于智能体稳定处理失败。
• 内置静态首页，展示工具目录、参数、示例、服务状态和镜像白名单。

工具列表

快速开始

环境要求：

• JDK 25+
• Maven 3.9+

本地运行：

$env:JAVA_HOME='D:\devProgram\jdk\jdk-26'
$env:Path='D:\devProgram\jdk\jdk-26\bin;D:\devProgram\apache-maven-3.9.6\bin;' + $env:Path
D:\devProgram\apache-maven-3.9.6\bin\mvn.cmd '-Dmaven.repo.local=D:\jarLibrary' spring-boot:run

访问：

• 首页：http://localhost:25924/
• MCP：http://localhost:25924/mcp
• 健康检查：http://localhost:25924/actuator/health

Docker Compose

项目包含从源码构建的 Dockerfile 和 docker-compose.yml。

docker compose up --build -d

查看状态：

docker compose ps
curl http://localhost:25924/actuator/health

停止服务：

docker compose down

配置

镜像白名单

工具入参中的 repositoryBaseUrl 或 registryBaseUrl 都是可选参数。传入时必须是对应生态白名单中的完整镜像地址；不传时使用逗号分隔列表中的第一个地址作为默认镜像。

常用环境变量

HTTP 代理

evernight:
  http:
    proxy-url: # http://127.0.0.1:7890, https://127.0.0.1:7890, socks5://127.0.0.1:1080
    connect-timeout-millis: 5000
    read-timeout-millis: 10000

缓存

evernight:
  cache:
    enabled: true
    maximum-size: 10000
    maven-ttl-seconds: 21600
    npm-ttl-seconds: 21600
    pypi-ttl-seconds: 21600
    osv-ttl-seconds: 3600

IP 限流

evernight:
  rate-limit:
    enabled: true
    client-ip-header: X-Evernight-Client-IP
    max-requests: 120
    window-seconds: 60

客户端 IP 解析优先级：client-ip-header 配置的请求头、X-Forwarded-For、X-Real-IP、remoteAddr。首页、静态资源、首页支撑接口和健康检查不会参与限流。

在线人数

在线人数按最近窗口内有请求的唯一客户端 IP 统计。首页、静态资源、首页支撑接口和 /actuator/* 健康检查请求不会计入人数；首页在服务健康状态为 UP 时会显示在线人数。

evernight:
  online-users:
    enabled: true
    window-seconds: 300
    maximum-size: 100000

测试

$env:JAVA_HOME='D:\devProgram\jdk\jdk-26'
$env:Path='D:\devProgram\jdk\jdk-26\bin;D:\devProgram\apache-maven-3.9.6\bin;' + $env:Path
D:\devProgram\apache-maven-3.9.6\bin\mvn.cmd '-Dmaven.repo.local=D:\jarLibrary' test

许可证

Evernight 使用 Apache License 2.0 开源协议。