MCP Integration

Clarissa supports the Model Context Protocol (MCP), allowing you to extend its capabilities by connecting to external MCP servers. This enables integration with databases, APIs, file systems, and custom tools.

What is MCP?

The Model Context Protocol is an open standard that allows AI applications to connect to external data sources and tools. MCP servers expose resources, prompts, and tools that Clarissa can use during conversations.

Connecting to MCP Servers

Use the /mcp command to connect to an MCP server:

/mcp <command> [args...]

Example: Filesystem Server

Connect to the official MCP filesystem server to give Clarissa access to a specific directory:

/mcp npx -y @modelcontextprotocol/server-filesystem /path/to/directory

This grants Clarissa additional file system tools scoped to the specified directory.

Example: Custom Server

Connect to any stdio-based MCP server:

/mcp node /path/to/my-mcp-server.js

How It Works

  1. When you connect to an MCP server, Clarissa establishes a stdio connection
  2. The server advertises its available tools to Clarissa
  3. These tools are dynamically registered and become available during your conversation
  4. Clarissa can then use these tools just like its built-in tools

Available MCP Servers

Some popular MCP servers you can use with Clarissa:

Server Description
@modelcontextprotocol/server-filesystem File system access with read/write operations
@modelcontextprotocol/server-github GitHub API integration
@modelcontextprotocol/server-postgres PostgreSQL database access
@modelcontextprotocol/server-sqlite SQLite database access

Browse more servers at the MCP Servers Repository.

Tool Categories

Tools from MCP servers are categorized as mcp tools and will be displayed alongside Clarissa's built-in tools.

Limitations

  • Currently only stdio-based MCP servers are supported
  • HTTP/SSE transport is planned for a future release
  • MCP connections persist for the duration of your session

Building Your Own Server

You can create custom MCP servers to integrate Clarissa with your own tools and services. See the MCP Documentation for guides on building servers in TypeScript, Python, and other languages.