# MCP Compass 🧭

[![Model Context Protocol](https://img.shields.io/badge/Model%20Context%20Protocol-purple)](https://modelcontextprotocol.org)

<a href="https://glama.ai/mcp/servers/85uxmq6wx7"><img width="380" height="200" src="https://glama.ai/mcp/servers/85uxmq6wx7/badge" alt="Compass MCP server" /></a>

## MCP Discovery & Recommendation

### Experience MCP Compass 🌐

You can now experience MCP discovery directly on our website!  
👉 **[Explore MCP Compass](https://mcphub.io/)** 👈  

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">
  <img src="assets/demo.png" alt="MCP Compass Demo - Airtable Server Search" width="800"/>
</div>

## 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 [![MCP Servers](https://img.shields.io/badge/MCP-Servers-red?logo=github)](https://github.com/modelcontextprotocol/servers)
- 🤝 **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
``` 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](LICENSE) file for details.

## Support 💬

- 🐛 [Report issues](https://github.com/liuyoshio/mcp-compass/issues)
- 💡 [Feature requests](https://github.com/liuyoshio/mcp-compass/issues)
- 📖 [Documentation](https://github.com/liuyoshio/mcp-compass)