Protocol
Moss MCP Server: Semantic Search for AI Coding Assistants
The @moss-tools/mcp-server package exposes Moss as a Model Context Protocol server, giving AI coding assistants like Claude Desktop, Cursor, and VS Code direct access to your knowledge base. Run it with npx - no installation required. The server provides tools for querying, indexing, and managing documents.
Benefits
Why Use Moss with MCP Server
Zero install: run with npx @moss-tools/mcp-server - works immediately with Claude Desktop, Cursor, and VS Code
Full Moss API exposed as MCP tools: query, create_index, load_index, add_docs, delete_docs, and more
AI assistants can search your knowledge base, create indexes, and manage documents conversationally
Sub-10ms search latency means AI assistants get context without noticeable delay
JSON configuration - add to claude_desktop_config.json or .cursor/mcp.json
Integration
Quick Start
// claude_desktop_config.json (or .cursor/mcp.json)
{
"mcpServers": {
"moss": {
"command": "npx",
"args": ["@moss-tools/mcp-server"],
"env": {
"MOSS_PROJECT_ID": "your-project-id",
"MOSS_PROJECT_KEY": "your-project-key"
}
}
}
}
// Exposed MCP tools:
// - query: Search an index with semantic + keyword hybrid search
// - load_index: Load an index into memory for fast queries
// - create_index: Create a new index from documents
// - list_indexes: List all available indexes
// - get_index: Get index metadata
// - delete_index: Remove an index
// - add_docs: Add documents to an existing index
// - get_docs: Retrieve documents by ID
// - delete_docs: Remove documents from an index
// - get_job_status: Check async job progressSetup
Get Started in 3 Steps
Add MCP server config
Add the Moss MCP server entry to your AI assistant's config file (claude_desktop_config.json for Claude Desktop, .cursor/mcp.json for Cursor).
Set environment variables
Provide your MOSS_PROJECT_ID and MOSS_PROJECT_KEY in the env section of the MCP config. The server authenticates with these credentials.
Start using tools
Restart your AI assistant. It can now query your Moss indexes, create new indexes, add documents, and manage your knowledge base through natural language.
FAQ
Frequently asked questions
Explore