MCP Compass

What is MCP Compass about?

Offers a smart guide that lets AI assistants locate and understand available MCP services through natural language queries, returning detailed information about each server.

How to use MCP Compass?

1. Install – either clone the repository or run it directly with npx:

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

2. Add the configuration to your AI assistant’s MCP settings (e.g., Claude Desktop config file).
3. Send natural‑language queries to the service; it returns matching MCP servers with metadata.

Key features of MCP Compass

• Smart Search – natural‑language queries to find MCP services.
• Rich Metadata – detailed info for each discovered server.
• Real‑time Updates – keeps the list of MCP servers current.
• Easy Integration – works with any MCP‑compatible assistant via simple configuration.

Use cases of MCP Compass

• An AI assistant needing to discover the most suitable MCP server for a specific task (e.g., data retrieval, translation).
• Developers building tools that require dynamic lookup of MCP services.
• Researchers exploring the ecosystem of available MCP servers.

FAQ from the MCP Compass

Q: Do I need an API key? A: No API key is required for the basic discovery service.

Q: Can I run the server locally? A: Yes – use the node command with the built index file as shown in the README.

Q: How are the server listings kept up‑to‑date? A: The service pulls the latest list from the official MCP servers repository.

Q: Which platforms are supported? A: Any environment that can run Node.js (macOS, Linux, Windows).

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

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

1. Clone the repository

or

2. 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:AppData\Claude\claude_desktop_config.json

1. 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"
         ]
      }
   }
   }
   

   or

   {
   "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