Skip to main content
Glama

Simple MCP Server

by banique15
npmGitHub
JavaScript
596
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Server Orchestration Project

An intelligent Model Context Protocol (MCP) orchestration system that demonstrates dynamic server coordination and AI-powered query routing. This project showcases how a primary MCP server can intelligently analyze natural language queries and dynamically call specialized MCP servers to provide comprehensive responses.

šŸ§  Architecture Overview

graph TD A[User Query] --> B[People-Info Orchestrator] B --> C[Claude AI Analysis] C --> D{Query Category} D -->|Developer Query| E[Start Developer-Info Server] D -->|Designer Query| F[Start Designer-Info Server] D -->|Other| G[Direct Response] E --> H[Call get_developer_name] F --> I[Call get_designer_name] H --> J[Claude Enhancement] I --> J G --> J J --> K[Natural Language Response] K --> A

šŸŽÆ How It Works

  1. User asks a natural language question like "What is the developer's name?"

  2. People-info orchestrator receives the query

  3. Claude AI analyzes the query to determine intent and category

  4. Orchestrator dynamically starts the appropriate specialized server

  5. MCP client calls the right tool on the specialized server

  6. Raw data is enhanced by Claude AI into a natural response

  7. User receives a conversational, helpful answer

šŸ—ļø Project Structure

MCP-Server/ ā”œā”€ā”€ people-info-server/ # šŸ§  Main orchestrator (ADD THIS TO CLAUDE DESKTOP) ā”‚ ā”œā”€ā”€ index.js # Intelligent routing and MCP client logic ā”‚ ā”œā”€ā”€ package.json # Dependencies including MCP client SDK ā”‚ ā”œā”€ā”€ .env.template # Environment template ā”‚ ā””ā”€ā”€ README.md # Detailed orchestrator documentation ā”œā”€ā”€ developer-info-server/ # šŸ‘Øā€šŸ’» Developer data server ā”‚ ā”œā”€ā”€ index.js # Returns developer information ā”‚ ā””ā”€ā”€ package.json # Simple MCP server ā”œā”€ā”€ designer-info-server/ # šŸŽØ Designer data server ā”‚ ā”œā”€ā”€ index.js # Returns designer information ā”‚ ā””ā”€ā”€ package.json # Simple MCP server ā”œā”€ā”€ setup.sh # One-command setup script ā”œā”€ā”€ QUICK_START.md # Super simple setup guide ā””ā”€ā”€ README.md # This file

šŸš€ Quick Start

šŸšØ IMPORTANT FOR NEW USERS: If you're setting up this project on a different machine, you need to update 2 critical paths. See the Path Configuration Guide below.

Option 1: One-Command Setup

./setup.sh

Option 2: Manual Setup

cd people-info-server npm install cp .env.template .env # Edit .env and add your ANTHROPIC_API_KEY

Add to Claude Desktop

Add only the orchestrator to your Claude Desktop MCP settings:

{ "mcpServers": { "people-info": { "command": "node", "args": ["/Users/banik/Desktop/Projects2025/MCP-Server/people-info-server/index.js"], "env": { "ANTHROPIC_API_KEY": "your_anthropic_api_key_here" } } } }

šŸŽ® Usage Examples

Natural Language Queries

Ask about developers:

<use_mcp_tool> <server_name>people-info</server_name> <tool_name>get_people_info</tool_name> <arguments> { "query": "What is the developer's name?" } </arguments> </use_mcp_tool>

Ask about designers:

<use_mcp_tool> <server_name>people-info</server_name> <tool_name>get_people_info</tool_name> <arguments> { "query": "Tell me about the designer on the team" } </arguments> </use_mcp_tool>

General questions:

<use_mcp_tool> <server_name>people-info</server_name> <tool_name>get_people_info</tool_name> <arguments> { "query": "Who is the frontend developer?" } </arguments> </use_mcp_tool>

šŸ”§ Technical Features

šŸ§  AI-Powered Query Analysis

  • Uses Claude 3.5 Sonnet to understand user intent

  • Categorizes queries as developer, designer, or other

  • Determines appropriate action (get name, get info, etc.)

šŸ”„ Dynamic Server Orchestration

  • Starts specialized MCP servers on-demand

  • Maintains connections for efficiency

  • Proper cleanup and resource management

šŸŒ Real MCP Protocol Communication

  • Uses official MCP SDK for client-server communication

  • Proper JSON-RPC protocol implementation

  • Error handling and fallback mechanisms

šŸ’¬ Natural Language Enhancement

  • Raw server responses enhanced by Claude AI

  • Conversational, context-aware answers

  • Maintains query context throughout the flow

šŸ“Š Data Separation

Developer-Info Server

  • Name: "Neick"

  • Purpose: Stores and provides developer information

  • Tool: get_developer_name

Designer-Info Server

  • Name: "Jesse"

  • Purpose: Stores and provides designer information

  • Tool: get_designer_name

People-Info Orchestrator

  • No data storage - pure orchestration logic

  • AI analysis and MCP client functionality

  • Response enhancement and natural language processing

šŸŽÆ Benefits of This Architecture

  1. Separation of Concerns: Each server has a single responsibility

  2. Scalability: Easy to add new specialized servers

  3. Natural Interface: Users can ask questions in plain English

  4. Dynamic Resource Usage: Servers only run when needed

  5. AI Enhancement: Raw data becomes conversational responses

  6. Real MCP Protocol: Demonstrates proper MCP client-server communication

šŸ” Example Interaction Flow

User Query: "What is the developer's name?"

  1. Orchestrator receives query

  2. Claude analyzes: {"category": "DEVELOPER", "action": "GET_NAME"}

  3. Orchestrator starts developer-info server

  4. MCP client calls get_developer_name tool

  5. Server responds: {"content": [{"type": "text", "text": "Neick"}]}

  6. Claude enhances: "The developer's name is Neick."

  7. User receives natural response

šŸ› ļø Development & Testing

Test Individual Servers

# Test developer server cd developer-info-server && npm start # Test designer server cd designer-info-server && npm start # Test orchestrator cd people-info-server && npm start

Add New Specialized Servers

  1. Create new server directory (e.g., manager-info-server)

  2. Implement MCP server with appropriate tools

  3. Update orchestrator's analysis logic to recognize new categories

  4. Add MCP client calls for the new server

šŸ† Advanced MCP Concepts Demonstrated

  • Multi-server orchestration

  • Dynamic server lifecycle management

  • MCP client-server communication

  • AI-powered request routing

  • Natural language query processing

  • Response enhancement and formatting

šŸ”§ Path Configuration for Sharing

If you're setting up this project on a different machine than the original developer, you need to update these paths:

1. Update Node.js Path in Code

Edit people-info-server/index.js line 84:

// Change this hardcoded path: command: '/Users/banik/.nvm/versions/node/v22.16.0/bin/node', // To use your system's Node.js: command: 'node',

2. Update Project Path in Claude Desktop Settings

Replace the hardcoded path in your Claude Desktop MCP settings:

{ "mcpServers": { "people-info": { "command": "node", "args": ["/YOUR/ACTUAL/PATH/TO/MCP-Server/people-info-server/index.js"], "env": { "ANTHROPIC_API_KEY": "your_anthropic_api_key_here" } } } }

Example paths:

  • macOS: "/Users/yourname/Desktop/MCP-Server/people-info-server/index.js"

  • Windows: "C:\\Users\\yourname\\Desktop\\MCP-Server\\people-info-server\\index.js"

  • Linux: "/home/yourname/Desktop/MCP-Server/people-info-server/index.js"

āœ… What Doesn't Need Changes

  • Developer-Info Server - Completely portable

  • Designer-Info Server - Completely portable

  • Internal server discovery - Uses relative paths automatically

šŸ“ License

This project is open source and available under the MIT License.

This project showcases advanced MCP patterns and serves as a reference for building intelligent, AI-powered MCP orchestration systems. šŸš€

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A minimalist MCP server that provides a single tool to retrieve a developer name, demonstrating the basic structure for Claude's Model Completion Protocol integration.

  1. šŸ§  Architecture Overview
    1. šŸŽÆ How It Works
      1. šŸ—ļø Project Structure
        1. šŸš€ Quick Start
          1. Option 1: One-Command Setup
          2. Option 2: Manual Setup
          3. Add to Claude Desktop
        2. šŸŽ® Usage Examples
          1. Natural Language Queries
        3. šŸ”§ Technical Features
          1. šŸ§  AI-Powered Query Analysis
          2. šŸ”„ Dynamic Server Orchestration
          3. šŸŒ Real MCP Protocol Communication
          4. šŸ’¬ Natural Language Enhancement
        4. šŸ“Š Data Separation
          1. Developer-Info Server
          2. Designer-Info Server
          3. People-Info Orchestrator
        5. šŸŽÆ Benefits of This Architecture
          1. šŸ” Example Interaction Flow
            1. šŸ› ļø Development & Testing
              1. Test Individual Servers
              2. Add New Specialized Servers
            2. šŸ† Advanced MCP Concepts Demonstrated
              1. šŸ”§ Path Configuration for Sharing
                1. 1. Update Node.js Path in Code
                2. 2. Update Project Path in Claude Desktop Settings
                3. āœ… What Doesn't Need Changes
              2. šŸ“ License

                Related MCP Servers

                • Calculator MCP Server

                  QuantGeekDev
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.
                  Last updated -
                  32
                  5
                  • Apple

                • MCP Easy Copy

                  f-is-h
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that automatically reads the Claude Desktop configuration file and presents all available MCP services in an easy-to-copy format at the top of the tools list.
                  Last updated -
                  1
                  18
                  3
                  MIT License
                  • Apple

                • mcp-framework-starter

                  QuantGeekDev
                  -
                  security
                  F
                  license
                  -
                  quality
                  A starter template for building Model Context Protocol (MCP) servers, enabling developers to create and add custom tools that can be integrated with Claude Desktop.
                  Last updated -
                  2
                  • Apple

                • my-mcp-server

                  15972289829
                  A
                  security
                  F
                  license
                  A
                  quality
                  A Model Context Protocol server that allows integration with Claude Desktop by creating and managing custom tools that can be executed through the MCP framework.
                  Last updated -
                  31
                  • Apple

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/banique15/MCP-Server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server