xeris-ai/mcp-server

3.1

If you are the rightful owner of mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The mcp-server is a Spring Boot application designed to protect MCP endpoints and validate JWTs issued by an auth-server.

mcp-server

This repository contains two independent Spring Boot applications for local development:

mcp-server (port 8081): Resource Server protecting MCP endpoints and validating JWTs issued by auth-server

Prerequisites

JDK 23 (as used in build files)
Gradle 8+ installed (to run builds; you can generate a wrapper by running: gradle wrapper)

Structure

mcp-server/

How to run locally

In one terminal:
- cd auth-server
- gradle bootRun The server will start at http://localhost:9000
In another terminal:
- cd mcp-server
- gradle bootRun The server will start at http://localhost:8081

Test with client_credentials

Obtain a token from auth-server (client id: demo-client, secret: demo-secret): curl -u demo-client:demo-secret
-d "grant_type=client_credentials"
-d "scope=mcp.read"
http://localhost:9000/oauth2/token
Call the protected endpoint on mcp-server: curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
http://localhost:8081/mcp/health

Notes

Do not use these keys and credentials in production. They are for local development only.
If you prefer using Gradle Wrapper, run gradle wrapper once inside each app to generate ./gradlew and ./gradlew.bat.