# MCP Compass π§
[](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 [](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)