Senior Consult MCP

🚀 Senior Consult MCP

Enable your AI agent to seek expert technical guidance from top-tier models.

An MCP server that links your AI agent to expert models (Claude, GPT, Gemini, DeepSeek, Z.ai) for architectural advice, code reviews, and solving complex problems.

🚀 Quick Start

1. Configure MCP Client

Add the following to your MCP settings (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "senior-consult": {
      "command": "npx",
      "args": ["-y", "senior-consult-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-key"
      }
    }
  }
}

2. Use It

• "Ask senior to review this authentication flow for security issues"
• "Get architecture advice on microservices vs monolith for our scale"
• "Code review this function for potential memory leaks"

✨ Features

• Multi-Provider: Supports Claude, GPT, Gemini, DeepSeek, Z.ai, and custom endpoints.
• Smart Memory: Token-aware history with auto-trimming.
• Optimized Prompts: Tuned to provide concise and actionable advice.
• Zero Config: Works out of the box with sensible defaults.

📦 Installation

Option A: npx (Recommended)

# No install needed - runs directly
npx -y senior-consult-mcp

Option B: Global

npm install -g senior-consult-mcp

Option C: Local Development

git clone https://github.com/silkyland/senior-consult-mcp.git
cd senior-consult-mcp
npm install
npm run build
npm start

🔧 Technical Details

Environment Variables

API Keys

Set at least one provider key:

ANTHROPIC_API_KEY=sk-ant-...      # Claude
OPENAI_API_KEY=sk-...             # GPT
GEMINI_API_KEY=...                # Gemini
DEEPSEEK_API_KEY=sk-...           # DeepSeek
ZAI_API_KEY=...                   # Z.ai (or ZHIPU_API_KEY)
OPENAI_COMPATIBLE_API_KEY=...     # Custom endpoint

Model Configuration (Optional)

Override default models:

# Claude
CLAUDE_MODEL=claude-sonnet-4-5
CLAUDE_URL=https://api.anthropic.com/v1/messages

# OpenAI
OPENAI_MODEL=gpt-4o
OPENAI_URL=https://api.openai.com/v1/chat/completions

# Gemini
GEMINI_MODEL=gemini-2.5-flash

# DeepSeek
DEEPSEEK_MODEL=deepseek-chat
DEEPSEEK_URL=https://api.deepseek.com/chat/completions

# Z.ai
ZAI_MODEL=glm-4-plus
ZAI_URL=https://open.bigmodel.cn/api/paas/v4/chat/completions

# Custom OpenAI-compatible
OPENAI_COMPATIBLE_MODEL=your-model
OPENAI_COMPATIBLE_URL=https://your-endpoint/v1/chat/completions

Full Example Config

{
  "mcpServers": {
    "senior-consult": {
      "command": "npx",
      "args": ["-y", "senior-consult-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-xxx",
        "DEEPSEEK_API_KEY": "sk-xxx",
        "GEMINI_API_KEY": "xxx",
        "CLAUDE_MODEL": "claude-sonnet-4-5",
        "DEEPSEEK_MODEL": "deepseek-reasoner"
      }
    }
  }
}

📚 Documentation

Tools

🤝 Contributing

We welcome contributions! Here's how you can help:

Ways to Contribute

• Report bugs: Open an issue with reproduction steps.
• Suggest features: Share ideas in discussions.
• Improve docs: Fix typos and add examples.
• Submit PRs: Bug fixes, new providers, and optimizations.

Development Setup

# Clone & install
git clone https://github.com/silkyland/senior-consult-mcp.git
cd senior-consult-mcp
npm install

# Build & test
npm run build

# Run locally
npm start

Pull Request Process

1. Fork the repo.
2. Create a feature branch (git checkout -b feature/awesome).
3. Make changes and add tests.
4. Commit (git commit -m 'Add awesome feature').
5. Push (git push origin feature/awesome).
6. Open a PR with a clear description.

Code Style

• TypeScript strict mode.
• ESLint + Prettier.
• Meaningful commit messages.
• Tests for new features.

📄 License

MIT

Questions? Open an issue or start a discussion.

Like this project? Give it a star to show support!