MCP Repository Server

概述

MCP 仓库服务器是一个集中化平台，用于管理和发现 Model Context Protocol (MCP) 的服务器和客户端仓库，促进开发者对 MCP 生态系统的探索和贡献。

快速开始

前提条件

• JDK 17+
• Maven 或 Gradle
• MySQL
• Redis

安装与设置

1. 克隆仓库：

   git clone https://github.com/your-org/mcp-repo-server.git
   cd mcp-repo-server
   

2. 配置应用：

   # 在 application.properties 中配置
   spring.datasource.url=jdbc:mysql://localhost:3306/mcprepo
   spring.datasource.username=your_username
   spring.datasource.password=your_password
   
   github.api.token=your_github_token
   

3. 启动应用：

   ./mvnw spring-boot:run
   

核心功能

• 仓库管理：浏览、过滤和搜索服务器/客户端仓库
• GitHub 集成：自动同步仓库元数据和 README
• 用户管理：基于 JWT 的认证和授权
• 内容管理：博客系统和用例展示
• 提交系统：新仓库提交流程和管理员审核

API 使用示例

获取服务器仓库列表

curl -X GET http://localhost:8080/api/v1/servers

提交新仓库

curl -X POST http://localhost:8080/api/v1/submissions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "type": "SERVER",
    "name": "My MCP Server",
    "repoUrl": "https://github.com/user/my-mcp-server",
    "description": "An implementation of MCP server"
  }'

技术栈

• 后端：Java 17+, Spring Boot 3.x, Spring Security, JPA
• 前端：Next.js 15.2.0, React 18.3.1, TypeScript, Shadcn UI
• 基础设施：Docker, Kubernetes, Nginx, GitHub Actions

项目结构

主要包目录：

• config/ - 配置类
• controller/ - API 控制器
• domain/ - 实体类
• service/ - 业务逻辑

贡献

欢迎贡献！请查看项目仓库中的贡献指南了解详情。

许可证

本项目基于 MIT 许可证 - 详见 LICENSE 文件。