MCP Client

A client for interacting with Model Context Protocol (MCP) servers using either stdio or SSE transport.

Installation

npm install
npm run build

Configuration

The client can be configured using a servers.json file at the root of the project. Here's an example:

{
  "mcpServers": {
    "empowerlocal-database-agent": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/path/to/your/mcp-server.js"
      ],
      "env": {
        "ENV": "LOCAL"
      }
    },
    "empowerlocal-sse-stage": {
      "type": "sse",
      "url": "http://your-server.example.com/api/mcp/sse",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "text/event-stream"
      },
      "forceEndpoint": true
    }
  }
}

Configuration Options

Stdio Server Configuration

• type: Must be "stdio"
• command: The command to execute (e.g., "node")
• args: Array of command arguments
• env: (Optional) Environment variables to set

SSE Server Configuration

• type: Must be "sse"
• url: The URL of the SSE endpoint
• headers: (Optional) HTTP headers to send with the request
• forceEndpoint: (Optional) Whether to attempt a workaround for servers that don't send endpoint events

Usage

List Configured Servers

npm run servers

Connect to a Configured Server

npm run server -- <server-name>

For example:

npm run server -- empowerlocal-database-agent

Direct Connection (Legacy Mode)

Connect to a stdio server:

npm start stdio /path/to/your/server.js

Connect to an SSE server:

npm start sse http://your-server.example.com/api/mcp/sse

With force endpoint option:

npm start sse http://your-server.example.com/api/mcp/sse --force-endpoint

Environment Variables

• ANTHROPIC_API_KEY: Required for using Anthropic Claude API
• MCP_AUTH_TOKEN: Bearer token for SSE authentication
• MCP_CUSTOM_HEADERS: JSON string of custom headers

Interactive Mode

Once connected, you'll enter an interactive chat loop where you can send queries to the MCP server through the Claude API.

Type 'quit' to exit the interactive session.