Hermann MCP Server

Model Context Protocol (MCP) server that exposes Hermann's learning and context APIs as tools for AI assistants.

Features

• store_learning - Store learnings/insights for AI agents
• get_learning - Retrieve stored learnings by type or ID
• store_context - Store conversation/session context
• get_context - Retrieve stored context by agent ID or context ID

Installation

From npm

npm install -g hermann-mcp-server

From source

cd /path/to/mcp-server-package
npm install
npm link

Configuration

1. Copy .env.example to .env:

cp .env.example .env

2. Update the values:

HERMANN_API_URL=https://your-api-gateway-url.com
HERMANN_API_KEY=your-api-key

Claude Desktop Integration

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "hermann": {
      "command": "hermann-mcp",
      "env": {
        "HERMANN_API_URL": "https://your-api-gateway-url.com",
        "HERMANN_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code Integration

Add this to your VS Code settings (.vscode/settings.json or User Settings):

{
  "github.copilot.chat.mcp.servers": {
    "hermann": {
      "command": "hermann-mcp",
      "env": {
        "HERMANN_API_URL": "https://your-api-gateway-url.com",
        "HERMANN_API_KEY": "your-api-key"
      }
    }
  }
}

Testing Locally

# Test the server
node index.js

The server will run on stdio and wait for MCP protocol messages.

Usage Examples

Once configured, you can ask Claude or GitHub Copilot to:

• "Store this bug fix pattern as a learning"
• "Retrieve learnings about authentication"
• "Store the current context for this session"
• "Get the context for agent XYZ"

API Endpoints

The server connects to these Lambda endpoints:

• POST /mcp/learning - Store learning
• GET /mcp/learning?type=X - Get learnings by type
• GET /mcp/learning?learning_id=X - Get specific learning
• POST /mcp/context - Store context
• GET /mcp/context?agent_id=X - Get context by agent
• GET /mcp/context?context_id=X - Get specific context

Development

To make changes:

1. Edit index.js
2. Restart Claude Desktop or VS Code to reload the MCP server
3. Or use the Command Palette: "MCP: Restart Servers"

Uninstall

npm uninstall -g hermann-mcp-server