MCP Server
Expose AgentForge tools as an MCP-compatible server.
MCPServer
import { MCPServer } from '@ahzan-agentforge/core';
const server = new MCPServer({
name: 'my-tools',
version: '1.0.0',
tools: [searchTool, lookupTool, calculateTool],
});
await server.start();MCPServerConfig
interface MCPServerConfig {
name: string; // Server name
version: string; // Server version
tools: Tool[]; // AgentForge tools to expose
}How It Works
The MCP Server:
- Listens on stdin for JSON-RPC 2.0 requests
- Handles
tools/list— returns tool definitions - Handles
tools/call— executes the tool and returns results - Converts AgentForge tool schemas to MCP format automatically
JSON-RPC Protocol
// Request: list tools
{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}
// Response
{"jsonrpc": "2.0", "id": 1, "result": {"tools": [...]}}
// Request: call a tool
{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "search", "arguments": {"query": "hello"}}}
// Response
{"jsonrpc": "2.0", "id": 2, "result": {"content": [{"type": "text", "text": "..."}]}}