Integrations
Provides access to MCP servers listed in the Model Context Protocol GitHub repository, allowing AI assistants to discover available services
Uses Mermaid for rendering architecture and data flow diagrams to visualize the MCP Advisor system architecture
Incorporates Shields.io badges in the README to display MCP status and links to MCP servers
MCP Advisor
MCP Advisor & Installation
Experience MCP Advisor
What is this?
MCP Advisor 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.
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
- Vector Search: Powered by OceanBase for high-performance semantic search
- Modular Architecture: Clean separation of concerns for maintainability and extensibility
Architecture
Data Flow
Quick Start
Usage
- Clone the repository
or
- Use
npx
Installation
For Claude Desktop, edit your claude_desktop_config.json
file:
MacOS/Linux
Windows
Transport Options
MCP Advisor supports two transport methods:
1. Stdio Transport (Default)
Use this for command-line tools and direct integrations.
Add to your AI assistant's MCP configuration to enable service discovery capabilities:
2. SSE Transport (HTTP Server)
Use this for remote servers or web-based integrations. Start the server with:
Environment variables for SSE configuration:
TRANSPORT_TYPE
: Set tosse
to use SSE transport (default is stdio)SERVER_PORT
: HTTP server port (default: 3000)SERVER_HOST
: HTTP server host (default: localhost)SSE_PATH
: SSE endpoint path (default: /sse)MESSAGE_PATH
: Messages endpoint path (default: /messages)
Connect to the server using:
- SSE endpoint:
http://localhost:3000/sse
- Messages endpoint:
http://localhost:3000/messages?sessionId=<SESSION_ID>
- Health check:
http://localhost:3000/health
3. REST Transport
Examples
Example Queries
Here are some example queries you can use with MCP Advisor:
Example Response
Troubleshooting
Common Issues
- Connection Refused
- Ensure the server is running on the specified port
- Check firewall settings
- Verify the host address is correct
- No Results Returned
- Try a more general query
- Check network connectivity to the registry API
- Verify API endpoints are correctly configured
- SSE Connection Drops
- Increase client timeout settings
- Check server logs for error messages
- Ensure proper CORS configuration if connecting from a browser
- Performance Issues
- Consider adding more specific search terms
- Check server resources (CPU/memory)
- Implement caching if making frequent similar queries
Logs
For detailed troubleshooting, check the logs in the logs
directory. Enable debug logging with:
Environment Variables
MCP Advisor can be configured using the following environment variables:
Variable | Description | Default | Required |
---|---|---|---|
TRANSPORT_TYPE | Transport method (stdio , sse , rest ) | stdio | No |
SERVER_PORT | HTTP server port for SSE/REST transport | 3000 | No |
SERVER_HOST | HTTP server host for SSE/REST transport | localhost | No |
SSE_PATH | SSE endpoint path | /sse | No |
MESSAGE_PATH | Messages endpoint path | /messages | No |
ENDPOINT | REST endpoint path | /rest | No |
DEBUG | Enable debug logging | false | No |
ENABLE_FILE_LOGGING | Enable logging to files | false | No |
LOG_LEVEL | Log level (debug, info, warn, error) | info | No |
API Documentation
REST API Endpoints
GET /health
Health check endpoint.
Response:
GET /sse
Server-Sent Events endpoint for establishing a connection.
Query Parameters:
- None
Response:
- Establishes an SSE connection
POST /messages
Endpoint for sending messages to an established SSE connection.
Query Parameters:
sessionId
(string, required): The session ID of the SSE connection
Request Body:
Response:
POST /rest
REST API endpoint for direct requests (when using REST transport).
Request Body:
Response:
Same as /messages
endpoint.
Test
with inspector
License
MIT License - See LICENSE file for details.
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A discovery and recommendation service that helps AI assistants find Model Context Protocol servers based on natural language queries.
Related MCP Servers
- AsecurityAlicenseAqualityAn enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.Last updated -40203TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.Last updated -9PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI agents to query Erick Wendel's talks, blog posts, and videos across different platforms using natural language.Last updated -55TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.Last updated -852TypeScript