mcp compass

Local 2025-08-31 23:17:07 0

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

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

MCP Compass Demo - Airtable Server Search

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

Quick Start ?

Usage

Clone the repository

Use npx

Installation

For Claude Desktop, edit your claude_desktop_config.json file:

MacOS/Linux

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

Windows

code $env:AppDataClaudeclaude_desktop_config.json

As an MCP Service:

Add to your AI assistant's MCP configuration to enable service discovery capabilities.

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

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

License ?

MIT License - See LICENSE file for details.

Support ?

[
  {
    "description": "n          Use this tool when there is a need to findn external MCP tools.n          It explores and recommends existing MCP servers from the n          internet, based on the description of the MCP Server n          needed. It returns a list of MCP servers with their IDs, n          descriptions, GitHub URLs, and similarity scores.n          ",
    "inputSchema": {
      "properties": {
        "query": {
          "description": "n                Description for the MCP Server needed. n                It should be specific and actionable, e.g.:n                GOOD:n                - 'MCP Server for AWS Lambda Python3.9 deployment'n                - 'MCP Server for United Airlines booking API'n                - 'MCP Server for Stripe refund webhook handling'nn                BAD:n                - 'MCP Server for cloud' (too vague)n                - 'MCP Server for booking' (which booking system?)n                - 'MCP Server for payment' (which payment provider?)nn                Query should explicitly specify:n                1. Target platform/vendor (e.g. AWS, Stripe, MongoDB)n                2. Exact operation/service (e.g. Lambda deployment, webhook handling)n                3. Additional context if applicable (e.g. Python, refund events)n                ",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "name": "recommend-mcp-servers"
  }
]