MCP Client

A TypeScript client for interacting with multiple Model Context Protocol (MCP) servers defined in an mcp.json configuration file.

Features

• Support for multiple MCP servers
• Automatic tool prefixing with server names
• Intelligent LLM-powered query routing to appropriate tools/servers
• Interactive chat interface

Setup

1. Install dependencies:

   npm install
   

2. Create a .env file with your Anthropic API key:

   ANTHROPIC_API_KEY=your_anthropic_api_key_here
   

3. Build the project:

   npm run build
   

Usage

Configuration

Create an mcp.json file in the project root with configurations for each MCP server:

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/files"]
    }
    // Add more MCP servers as needed
  }
}

Running the Client

npm start

Or with a custom config path:

npm start -- /path/to/custom/mcp.json

How It Works

1. The client connects to all servers defined in the mcp.json file
2. Each tool from each server is prefixed with the server name (e.g., "github_searchRepo")
3. When you enter a query, the LLM decides which tool(s) to call based on your request
4. The client routes the tool call to the appropriate server and returns the results

Development

• Edit index.ts to modify the client
• Run npm run build to compile TypeScript to JavaScript
• Run npm start to start the client