Model Context Protocol (MCP) · knowledge base · LLM memory

Synamcps

Open-source MCP server & knowledge gateway for enterprises

Self-host MCP servers alongside a searchable knowledge base API and durable retrieval for LLM memory workflows—all behind ACL, scoped tokens, rate limits, and Prometheus metrics. Connect Cursor, Claude Desktop, or any MCP-compatible client to your organization's knowledge.

OIDC · Keycloak · Google · Teleport JWT· pgvector / Qdrant· S3 / MinIO
Synamcps — Model Context Protocol server and enterprise knowledge base for LLMs

Built for teams, not demos

Run MCP servers for employees and agents behind real ACL: share a secure knowledgebase for RAG, grounding, and long-lived LLM memory—without leaking data across users or teams.

Self-hosted MCP server for teams

Production Model Context Protocol (MCP) over streamable HTTP at /mcp for Cursor, Claude Desktop, Claude Code, and compatible clients. Legacy SSE optional.

Knowledge storage gateway

Store text, files and links. Auto extraction, summaries and embeddings into pgvector or Qdrant. S3 for raw blobs.

ACL & RBAC per storage

Bind users and groups to storages with read / write / admin / owner permissions. Personal, group and public visibility.

Scoped access tokens

Tokens narrow — never expand — owner permissions. Restrict by storageIds, mode, tool allowlist and rate limits.

Rate limits & metrics

Per-token minute/hour/day + burst limits. Usage events to Redis TimeSeries. Prometheus /metrics out of the box.

Enterprise auth

OIDC, Keycloak, Google, Teleport Proxy JWT — plus internal login for the Admin UI. Strict CORS allowlist.

A clean HTTP & MCP API

Ingest text, files or links. Search semantically. Manage everything via the admin API or the built-in UI. MCP tools/list is dynamic — clients only see tools and storages allowed by their token.

  • POST /api/knowledge — create from text
  • POST /api/knowledge/ingest/file — upload
  • POST /api/knowledge/ingest/link — crawl URL
  • POST /api/knowledge/search — semantic search
  • /api/admin/* — users, groups, storages, tokens
  • /metrics — Prometheus format
search.sh
curl -X POST http://localhost:8080/api/knowledge/search \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "kubernetes ingress timeout",
    "topK": 10,
    "filters": { "storageId": "team-sre" }
  }'

Run it in two commands

Docker Compose ships Postgres, Redis, S3/MinIO and Synamcps. Open the admin UI at localhost:8080/login.

# clone & start
git clone https://github.com/synamcps/synamcps-server
cd synamcps-server
cp .env.example .env
make compose-up