MCP Template

Szablon serwera MCP w Javie, gotowy do pracy za MCP Gateway.

Terminal
$ git clone https://github.com/aiwcorpo/mcp-server-template.git
$ cd mcp-server-template && ./mvnw verify
$ ./new-server.sh crm
# nowy serwer w ../mcp-server-crm

Architektura heksagonalna

mcp-toolsnarzędzia widoczne dla agenta
mcp-applicationprzypadki użycia
mcp-coredomena, bez zależności od frameworka
mcp-integrationadapter do Waszego systemu
mcp-appuruchomienie i konfiguracja

Co dostajecie

Ryzyko każdego narzędzia

@Tool(name = "delete_page", description = "...")
@ToolRisk(RiskLevel.DESTRUCTIVE)
@ToolTitle("Delete page")
READ_ONLYUPDATEDESTRUCTIVE

Poświadczenie z gateway, bez sekretów w serwerze

aiwcorpo:
  mcp:
    platform:
      auth-mode: gateway   # dev-pat tylko w profilu dev
Gateway dołącza do wywołania token OAuth, PAT albo konto serwisowe. Serwer niczego nie przechowuje.

Bezpieczne komunikaty błędów

if (ex instanceof PageNotFoundException) {
    return Optional.of(new SafeError(
        ToolErrorCode.NOT_FOUND_OR_DENIED.code(),
        ToolErrorCode.NOT_FOUND_OR_DENIED_MESSAGE));
}
Agent nie widzi śladów stosu ani danych wewnętrznych.

Audyt bez dodatkowego kodu

{ "server": "mcp-confluence",
  "tool": "delete_page",
  "risk": "DESTRUCTIVE",
  "username": "anna.nowak",
  "outcome": "ok" }

Parametry

Język
Java 25
Framework
Spring Boot 4.1, Spring AI 2.0
Budowanie
Maven
Biblioteka
mcp-platform-starter 4.0
Polityki
Cedar, w jarze serwera
Endpoint
MCP przez HTTP
Działa z
MCP Gateway 2.0

Porozmawiajmy o Waszych systemach

Umów rozmowę