Slate

The Ginkgoo Core MCP Service is a microservice project based on Java and Spring Boot, providing MCP management functions, supporting OAuth2 authentication and PostgreSQL databases.

Developer tools Security #Microservice #Permission Management #PostgreSQL #Spring Boot .Java

rating : 2 points

downloads : 6.6K

update time : 2025-04-28

Open Site

What is the Ginkgoo Core MCP Service?

The Ginkgoo Core MCP Service is a modern server built on Java and Spring Boot, designed to manage and optimize the Model Context Protocol. It supports authentication, health checks, and integration with other systems.

How to use the Ginkgoo Core MCP Service?

You can quickly start the service by cloning the code repository, installing dependencies, and running the server. The service provides simple and easy - to - use API interfaces for developers to integrate.

Applicable Scenarios

Suitable for enterprise - level applications that require efficient management of model context, implementation of authentication, and interaction with external systems.

Main Features

MCP Management

Provides comprehensive MCP management functions, including configuration, monitoring, and maintenance.

OAuth2 Authentication

Implements a secure authentication mechanism through Spring Security and OAuth2.

Health Check

Regularly detects the service status and returns a health report.

Advantages

Developed based on a modern technology stack (Java 23, Spring Boot 3.x), with superior performance.

Supports multiple authentication methods to ensure data security.

Easy to expand and maintain, suitable for long - term use.

Limitations

Requires high - level hardware resource configuration, such as JDK 21+ and PostgreSQL 14+.

Initial deployment may involve a certain learning cost.

How to Use

Clone the Code Repository

Use the Git tool to clone the Ginkgoo Core MCP Service code repository to your local machine.

Install Dependencies

Use the Maven tool to download the project's required dependencies.

Start the Service

Run the Spring Boot application to start the Ginkgoo Core MCP Service.

Usage Examples

Administrator Manages MCP Configuration

Administrators can easily add, delete, or modify MCP configurations.

User Authentication

Users can log in to the system via their Google accounts.

Frequently Asked Questions

What dependency environments does the Ginkgoo Core MCP Service require?

How to enable OAuth2 authentication?

How to troubleshoot problems when the service encounters an exception?

Related Resources

Official Documentation

Detailed user manuals and technical references.

GitHub Code Repository

Open - source code repository.

Community Forum

User communication platform.

🚀 Ginkgo Core MCP Service

This project provides the MCP service, offering management functions and ensuring service stability through a series of technical stacks and configurations.

✨ Features

Completed ✅

MCP management

In Progress 🚧

📦 Installation

Prerequisites

JDK 21+
PostgreSQL 14+
Maven 3.8+

Steps

git clone <repository-url>
cd ginkgoo-mcp
mvn clean install
mvn spring-boot:run

💻 Usage Examples

Health Check

The health status of the service can be viewed through the following interface:

GET /health

# Response:
{
    "status": "UP"
}

Configuration

spring:
  security:
    oauth2:
      client:
        registration:
          google:
            client-id: ${GOOGLE_CLIENT_ID}
            client-secret: ${GOOGLE_CLIENT_SECRET}

  datasource:
    url: ${POSTGRES_URL}
    username: ${POSTGRES_USER}
    password: ${POSTGRES_PASSWORD}

🔧 Technical Details

Technology Stack

Property	Details
Model Type	Java 23, Spring Boot 3.x, Spring Security & Spring Authentication Server, PostgreSQL, JWT

📄 License

This project uses a dual-license model:

Open Source License (AGPL-3.0): This software is distributed under the GNU Affero General Public License, Version 3.0 (AGPL-3.0). For details, please refer to the LICENSE file.
Commercial License: If you wish to use this software without complying with AGPL-3.0, or require a proprietary license with different terms, please contact license@ginkgoo.ai.

🤝 Contribution Guidelines

We welcome your contributions! Please read our Contributing Guide before submitting issues or pull requests.

📜 Code of Conduct

To create a welcoming and inclusive environment, we adhere to our Code of Conduct. All contributors are required to follow these guidelines.

📝 Contributor License Agreement (CLA)

Before making any contributions, you must agree to our CLA. This agreement ensures that all contributions are consistent with the project's dual-license model.

If you encounter any issues, please contact license@ginkgoo.ai.