Back to Home
TillMatthis icon

KOmcp

Verified Safe

by TillMatthis

Overview

Provides a secure, OAuth2-authenticated Model Context Protocol (MCP) server that enables LLM applications like Claude to manage (create, search, retrieve, delete) Kura notes via API calls.

Installation

Run Command
npm run dev

Environment Variables

  • BASE_URL
  • KOAUTH_URL
  • KOAUTH_JWKS_URL
  • KOAUTH_CLIENT_REGISTRATION_URL
  • KURA_DATABASE_URL
  • KURA_URL

Security Notes

The server demonstrates robust security practices: Fastify with Helmet, CORS (configurable origins), and Rate Limiting. OAuth2 token validation is thorough, using JWKS for signature verification and checking issuer, audience, and expiration. Role-based access control is enforced via `requireScopes` middleware. Logging (Pino) is structured and redacts sensitive data like Authorization headers. Docker deployment uses a non-root user. Critically, KOmcp interacts with Kura via its HTTP API (`KuraClient` uses `fetch`), shifting direct database access and potential SQL injection risks to the Kura application itself. A minor inconsistency is that `src/config/env.ts` validates for `KURA_DATABASE_URL` while `src/services/kura-client.ts` uses `KURA_URL` to connect to Kura's API, which might lead to unnecessary environment variable requirements, but does not pose a direct security vulnerability.

Similar Servers

Stats

Interest Score0
Security Score9
Cost ClassHigh
Avg Tokens5000
Stars0
Forks0
Last Update2025-12-05

Tags

MCPModel Context ProtocolOAuth2LLM IntegrationSemantic SearchKuraAPI GatewayNode.jsTypeScriptFastifyDocker