MCP Compass
MCP Compass is a discovery and recommendation service that assists AI assistants in finding and understanding Model Context Protocol servers through natural language queries.
What is MCP Compass?
MCP Compass is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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 Compass is a discovery and recommendation service that assists AI assistants in finding and understanding Model Context Protocol servers through natural language queries.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP Compass is a discovery and recommendation service that a
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-compassConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Compass
MCP Compass is a discovery and recommendation service that allows AI assistants to search the MCP ecosystem using natural language queries, returning relevant server metadata, capability descriptions, and integration guidance without requiring the user to manually browse registries. Instead of asking developers to sift through lists of hundreds of MCP servers, Compass lets the AI itself find the right tool by asking questions like 'find me a server that can query databases' or 'what MCP servers are available for web scraping'. It is particularly valuable in agentic workflows where the assistant needs to autonomously select and connect to appropriate MCP services.
Prerequisites
- Node.js 18 or later installed
- npx available (bundled with Node.js 7+)
- An MCP-compatible AI client such as Claude Desktop, Cursor, or VS Code with Copilot
- Internet access for real-time MCP server index queries
Verify Node.js is installed
Confirm Node.js and npx are available before configuring the server. MCP Compass requires Node.js 18 or later.
node --version
npx --versionTest the server locally
Run MCP Compass via npx to confirm it starts correctly. The -y flag skips the installation confirmation prompt.
npx -y @liuyoshio/mcp-compassOpen your MCP client configuration
Open your claude_desktop_config.json. On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%\Claude\claude_desktop_config.json.
Add MCP Compass to the configuration
Add the mcp-compass server entry. No API keys or environment variables are required — the server works out of the box.
{
"mcpServers": {
"mcp-compass": {
"command": "npx",
"args": ["-y", "@liuyoshio/mcp-compass"]
}
}
}Restart your MCP client
Save the configuration file and fully restart Claude Desktop or your chosen MCP client. MCP Compass will appear as a connected server.
Search for MCP servers using natural language
Ask your AI assistant to find MCP servers for a specific use case. The Compass server will query its index and return relevant results with metadata, capabilities, and installation information.
MCP Compass Examples
Client configuration
Complete Claude Desktop configuration for MCP Compass. No API keys are required.
{
"mcpServers": {
"mcp-compass": {
"command": "npx",
"args": ["-y", "@liuyoshio/mcp-compass"]
}
}
}Prompts to try
Example prompts to discover MCP servers using Compass's natural language search.
- "Find MCP servers that can interact with databases"
- "What MCP servers are available for web scraping and data extraction?"
- "Search for MCP servers that integrate with Airtable or Google Sheets"
- "Find a server that can send emails or Slack messages"
- "What MCP servers exist for GitHub repository management?"
- "Are there any MCP servers for OSINT or cybersecurity research?"Troubleshooting MCP Compass
npx fails with 'package not found' for @liuyoshio/mcp-compass
Ensure you have internet access and your npm registry is reachable. Run 'npm ping' to test connectivity. If behind a corporate proxy, set the HTTP_PROXY and HTTPS_PROXY environment variables before running npx.
MCP Compass returns no results for my query
Try rephrasing your query with more general terms. Compass uses semantic search so exact product names are not required — describe the capability you need (e.g., 'database queries' rather than 'MySQL connector'). Ensure you have internet access as Compass queries a live index.
Server shows as connected but the AI says no tools are available
Restart Claude Desktop completely (not just reload). Check the MCP server logs for startup errors by opening Claude Desktop's developer console. Verify the package name @liuyoshio/mcp-compass is spelled correctly including the scope prefix.
Frequently Asked Questions about MCP Compass
What is MCP Compass?
MCP Compass is a Model Context Protocol (MCP) server that mcp compass is a discovery and recommendation service that assists ai assistants in finding and understanding model context protocol servers through natural language queries. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Compass?
Follow the installation instructions on the MCP Compass GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Compass?
MCP Compass works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Compass free to use?
Yes, MCP Compass is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
MCP Compass Alternatives — Similar Developer Tools Servers
Looking for alternatives to MCP Compass? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Compass in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Compass?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.