Crosmos Server

FreeNot checked

MCP server for the Crosmos memory layer, enabling semantic, keyword, and graph retrieval of memories, as well as storing content with automatic entity and relat

by crosmos-labs

GitHub Embed

About

MCP server for the Crosmos memory layer, enabling semantic, keyword, and graph retrieval of memories, as well as storing content with automatic entity and relation extraction.

README

Beta — Crosmos is in early access. APIs and features may change. Feedback welcome at github.com/crosmos-org/crosmos-mcp.

MCP server for the Crosmos memory layer.

Tools

Tool	Description
`crosmos_search_memories`	Semantic + keyword + graph retrieval
`crosmos_add_memory`	Store content with auto entity/relation extraction
`crosmos_list_spaces`	List available memory spaces
`crosmos_health_check`	Verify API connectivity and status

Quick Start

npx @crosmos/crosmos-mcp setup

This runs the interactive setup:

Authenticate — Enter your API key (get one at console.crosmos.dev)
Install to clients — Auto-detects installed MCP clients (Claude Desktop, Claude Code, opencode, Cursor, VS Code, Windsurf, Cline, Roo-Cline, Zed, Kimi CLI) and writes the server config
Install skill — Auto-detects your AI editor(s) and installs the Crosmos skill

No global install needed — npx handles everything. Clients are configured to run npx -y @crosmos/crosmos-mcp so they always pick up the latest version.

Manual Setup

1. Authenticate

npx @crosmos/crosmos-mcp auth login

Or set the environment variable:

export CROSMOS_API_KEY=csk_your_api_key_here

2. Configure your client

Claude Desktop

Config location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "crosmos-memory": {
      "command": "npx",
      "args": ["-y", "@crosmos/crosmos-mcp"]
    }
  }
}

Claude Code

claude mcp add crosmos-memory -- npx -y @crosmos/crosmos-mcp

opencode

~/.config/opencode/opencode.json:

{
  "mcp": {
    "crosmos-memory": {
      "type": "local",
      "command": ["npx", "-y", "@crosmos/crosmos-mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "crosmos-memory": {
      "command": "npx",
      "args": ["-y", "@crosmos/crosmos-mcp"]
    }
  }
}

VS Code

macOS: ~/Library/Application Support/Code/User/mcp.json
Linux: ~/.config/Code/User/mcp.json
Windows: %APPDATA%\Code\User\mcp.json

{
  "servers": {
    "crosmos-memory": {
      "command": "npx",
      "args": ["-y", "@crosmos/crosmos-mcp"]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "crosmos-memory": {
      "command": "npx",
      "args": ["-y", "@crosmos/crosmos-mcp"]
    }
  }
}

Kimi CLI

kimi mcp add --transport stdio crosmos-memory -- npx -y @crosmos/crosmos-mcp

Other MCP clients

The server uses stdio transport. Point your client to npx -y @crosmos/crosmos-mcp and set:

Variable	Value
`CROSMOS_API_KEY`	Your API key (`csk_...`)
`CROSMOS_API_BASE_URL`	`https://api.crosmos.dev` (default)

3. (Optional) Install the skill

npx @crosmos/crosmos-mcp skill install opencode    # or: cursor, claude-code, windsurf, vscode, kimi-cli

CLI Reference

npx @crosmos/crosmos-mcp                     # Start MCP server (stdio)
npx @crosmos/crosmos-mcp setup               # Interactive setup (auth + client install + skill)
npx @crosmos/crosmos-mcp auth login          # Authenticate with API key
npx @crosmos/crosmos-mcp auth login --base-url URL # Custom API base URL
npx @crosmos/crosmos-mcp auth logout         # Remove stored credentials
npx @crosmos/crosmos-mcp auth status         # Show auth state
npx @crosmos/crosmos-mcp skill install <client>  # Install Crosmos skill

Environment Variables

Variable	Description	Default
`CROSMOS_API_KEY`	API key (overrides credentials file)	—
`CROSMOS_API_BASE_URL`	API base URL	`https://api.crosmos.dev`
`CROSMOS_API_TIMEOUT`	Request timeout (ms)	`30000`
`DEFAULT_SPACE_ID`	Default memory space UUID	—
`DEFAULT_SPACE_NAME`	Default memory space name (resolved via `/spaces?name=`); ignored if `DEFAULT_SPACE_ID` is set	—

Credential resolution order: CROSMOS_API_KEY env var → ~/.crosmos/credentials.json → error.

Development

npm run dev          # stdio mode with watch
npm run dev:http     # HTTP mode with watch
npm run build        # compile TypeScript
npm run lint         # biome check
npm run format       # biome format

License

MIT

from github.com/crosmos-labs/crosmos-mcp

Install Crosmos Server in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install crosmos-mcp-server

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add crosmos-mcp-server -- npx -y @crosmos/crosmos-mcp

FAQ

Is Crosmos Server MCP free?

Yes, Crosmos Server MCP is free — one-click install via Unyly at no cost.

Does Crosmos Server need an API key?

No, Crosmos Server runs without API keys or environment variables.

Is Crosmos Server hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Crosmos Server in Claude Desktop, Claude Code or Cursor?

Open Crosmos Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.

by Community

Template MCP Server

A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure

by mcpdotdirect

Compare Crosmos Server with

Crosmos ServervsGitHub Crosmos ServervsFilesystem Crosmos ServervsMemory Crosmos ServervsTemplate MCP Server

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs