MCP Expert Server
About
A Model Context Protocol server utilizing Claude AI for generating intelligent queries and offering documentation assistance based on API documentation analysis.
Details
- Author
- crazyrabbitLTC
- Repository
- crazyrabbitLTC/mcp-expert-server
- GitHub stars
- 3
- Downloads
- 3
- Categories
- AI, Developer Tools, Other, API, Knowledge Base, Productivity, Design, Workplace, File Management, Search, Infrastructure, Frontend, Project Management
Jump to
- Two tools: create-query and documentation
- Supports .txt, .md, and .json documentation files
- Customizable prompts stored in the prompts/ directory
- TypeScript-based, modular architecture with an ExpertService class
- Debug logs written to stderr with [DEBUG] prefix
- Integrates natively with Claude Desktop via MCP configuration
Setting up with Highlight
Follow these steps to add this server as a custom Highlight plugin:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Expert ServerCommand (node, npx, python, etc.)nodeArguments-
Argument 1
/ABSOLUTE/PATH/TO/expert-server/build/index.js
Environment-
ANTHROPIC_API_KEY
your_api_key_here
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- ANTHROPIC_API_KEY: Your Anthropic API key (required)
create-query
Generates queries based on natural language requests. Example: request (string)
documentation
Provides relevant documentation information based on questions. Example: request (string)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp expert server": {
"env": {
"ANTHROPIC_API_KEY": "your_api_key_here"
},
"args": [
"/ABSOLUTE/PATH/TO/expert-server/build/index.js"
],
"command": "node"
}
}
}Linux
{
"env": {
"ANTHROPIC_API_KEY": "your_api_key_here"
},
"args": [
"/ABSOLUTE/PATH/TO/expert-server/build/index.js"
],
"command": "node"
}Macos
{
"env": {
"ANTHROPIC_API_KEY": "your_api_key_here"
},
"args": [
"/ABSOLUTE/PATH/TO/expert-server/build/index.js"
],
"command": "node"
}Windows
{
"env": {
"ANTHROPIC_API_KEY": "your_api_key_here"
},
"args": [
"/ABSOLUTE/PATH/TO/expert-server/build/index.js"
],
"command": "node"
}MCP Expert Server
A Model Context Protocol server that provides intelligent query generation and documentation assistance using Claude AI. The server analyzes your API documentation and provides two main tools:
- create-query: Generates queries based on natural language requests
- documentation: Provides relevant documentation information based on questions
Prerequisites
- Node.js >= 18
- An Anthropic API key for Claude
Installation
1. Clone the repository
2. Install dependencies:
npm install
3. Create a
.env file with your Anthropic API key:ANTHROPIC_API_KEY=your_api_key_here
Setup
Before running the server, you need to:
1. Build the project and run the setup script:
npm run build
npm run setup
This will:
- Create the required directories (docs/ and prompts/)
- Create default prompt files
- Generate an initial service description
2. Add your API documentation files to the docs/ directory (supports .txt, .md, and .json files)
3. Optionally customize the prompts in the prompts/ directory:
- system-prompt.txt: Main system prompt for Claude
- tool-metadata.txt: Additional context for tool descriptions
- query-metadata.txt: Additional context for query generation
- service-description.txt: Auto-generated service description
Usage
Standalone Server
Start the server:
npm start
The server exposes two tools via the Model Context Protocol:
- create-query: Generate a query based on natural language request
{
"name": "create-query",
"arguments": {
"request": "Find all users who signed up in the last week"
}
}
- documentation: Get information from the documentation
{
"name": "documentation",
"arguments": {
"request": "How do I authenticate API requests?"
}
}
Claude Desktop Integration
1. Add this configuration to your Claude Desktop config file:
{
"mcpServers": {
"expert": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/expert-server/build/index.js"],
"env": {
"ANTHROPIC_API_KEY": "your_api_key_here"
}
}
}
}
2. Replace /ABSOLUTE/PATH/TO/expert-server with the actual absolute path to your server installation.
3. Restart Claude Desktop.
Directory Structure
.
├── docs/ # Your API documentation files
├── prompts/ # System prompts and metadata
│ ├── system-prompt.txt # Main system prompt
│ ├── tool-metadata.txt # Tool description context
│ ├── query-metadata.txt # Query generation context
│ └── service-description.txt # Generated service description
├── src/ # Source code
│ ├── index.ts # Entry point
│ ├── server.ts # MCP server implementation
│ └── services/ # Core services
│ └── expertService.ts # Claude integration
└── package.json
Development
- Build the project:
npm run build
- The server uses TypeScript and follows a modular architecture
- All Claude interactions are handled by the ExpertService class
- Debug logs are written to stderr with [DEBUG] prefix
Troubleshooting
If you encounter connection issues:
1. Ensure you've run the setup script:
npm run setup
2. Check that all required files exist in the prompts/ directory
3. Verify your ANTHROPIC_API_KEY is correctly set
4. Use absolute paths in your Claude Desktop config
5. Check the debug logs (written to stderr)
Environment Variables
- ANTHROPIC_API_KEY: Your Anthropic API key (required)
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
