Compass MCP Server

Developer ToolsTypeScript

MCP discovery and recommendation service

Available Tools

search

Search for MCP servers based on natural language queries

query

getServerDetails

Get detailed information about a specific MCP server

serverId

listCategories

List all available MCP server categories

Compass is a discovery and recommendation service that helps you explore Model Context Protocol servers. It acts as a smart guide that helps AI assistants find and understand available MCP services based on natural language queries, making it easier to discover and utilize the right tools for specific tasks. With Compass, you can search for MCP services using natural language, get detailed metadata about each service, and stay up-to-date with the latest MCP services. It's designed to simplify the process of finding the right MCP server for your specific needs, enhancing the capabilities of your AI assistant.

What is Compass?

Compass is a discovery and recommendation service for Model Context Protocol (MCP) servers. It helps AI assistants find and understand available MCP services through natural language queries, making it easier to discover and utilize the right tools for specific tasks.

Features

Smart Search: Find MCP services using natural language queries
Rich Metadata: Get detailed information about each service
Real-time Updates: Always up-to-date with the latest MCP services
Easy Integration: Simple to integrate with any MCP-compatible AI assistant

Installation

You can install Compass in two ways:

Method 1: Using npx (Recommended)

This method allows you to use the latest version without manually cloning the repository.

Edit your AI assistant's configuration file:

For Claude Desktop:
- MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %AppData%\Claude\claude_desktop_config.json
Add the following configuration:

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

Method 2: Manual Installation

If you prefer to clone the repository and run it locally:

Clone the repository:

git clone https://github.com/liuyoshio/mcp-compass.git

Navigate to the repository directory:
```
cd mcp-compass
```
Install dependencies:
```
pnpm install
```
Build the project:
```
pnpm build
```
Edit your AI assistant's configuration file to point to your local build:

{
  "mcpServers": {
    "mcp-compass": {
      "command": "node",
      "args": [
        "/path/to/repo/build/index.js"
      ]
    }
  }
}

Usage

Once installed, you can use Compass through your AI assistant by asking questions about MCP servers. For example:

"Can you find an MCP server for working with Airtable?"
"What MCP servers are available for database operations?"
"I need an MCP server that can help with file management"

Compass will interpret your query and provide recommendations for relevant MCP servers along with details about their capabilities.

Web Interface

You can also explore MCP servers directly through the Compass web interface at https://mcphub.io/, which provides a user-friendly way to discover and learn about available MCP services.