MCP Compass

by liuyoshio

192 stars

1 downloads

Not rated

GitHub

About

MCP Compass is a discovery and recommendation service that assists AI assistants in finding and understanding Model Context Protocol servers through natural language queries.

Details

Author: liuyoshio
Repository: liuyoshio/mcp-compass
GitHub stars: 192
Downloads: 1
License: MIT License
Categories: Search, Knowledge Base, AI, Other

- 🔍 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

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name MCP Compass

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @liuyoshio/mcp-compass
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

From the repository

For Claude Desktop, edit your claude_desktop_config.json file:

<div align="center">
MCP Compass Demo - Airtable Server Search
</div>

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp compass": {
            "cwd": "string",
            "env": {},
            "args": [
                "-y",
                "@liuyoshio/mcp-compass"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Linux

{
    "cwd": "string",
    "env": [],
    "args": [
        "-y",
        "@liuyoshio/mcp-compass"
    ],
    "shell": false,
    "command": "npx"
}

Macos

{
    "cwd": "string",
    "env": [],
    "args": [
        "-y",
        "@liuyoshio/mcp-compass"
    ],
    "shell": false,
    "command": "npx"
}

Windows

{
    "cwd": "string",
    "env": [],
    "args": [
        "-y",
        "@liuyoshio/mcp-compass"
    ],
    "shell": false,
    "command": "npx"
}

MCP Compass 🧭

MCP Discovery & Recommendation

Experience MCP Compass 🌐

You can now experience MCP discovery directly on our website!
👉 Explore MCP Compass 👈

Dive in to discover the power of MCP services in action with real-time recommendations and insights.

---

What is this? 🤔

MCP Compass is a discovery & 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 out there based on natural language queries, making it easier to discover and utilize the right tools for specific tasks.

Quick Example

<div align="center"> MCP Compass Demo - Airtable Server Search

</div>

Features 🌟

Quick Start 🚀

Usage

1. Clone the repository

2. Use npx

Installation

For Claude Desktop, edit your claude_desktop_config.json file:

MacOS/Linux

 bash
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows
 bash
code $env:AppData\Claude\claude_desktop_config.json

1. As an MCP Service:
Add to your AI assistant's MCP configuration to enable service discovery capabilities.
 json

   {

   "mcpServers": {

      "mcp-compass": {

         "command": "npx",

         "args": [

            "-y",

            "@liuyoshio/mcp-compass"

         ]

      }

   }

   }

   

   or
 json

   {

   "mcpServers": {

      "mcp-compass": {

         "command": "node",

         "args": [

            "/path/to/repo/build/index.js"

         ]

      }

   }

   }

License 📝

MIT License - See LICENSE file for details.

Support 💬

- 🐛 Report issues
- 💡 Feature requests
- 📖 Documentation

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

MCP Compass 🧭

MCP Discovery & Recommendation

Experience MCP Compass 🌐

What is this? 🤔

Quick Example

Features 🌟

Quick Start 🚀

Usage

Installation

MacOS/Linux

Windows

License 📝

Support 💬

Install

More like this

Aws Kb Retrieval Server

Memory

Brave Search

Context 7

1Panel

🔎 GPT Researcher