v3-mcp-optimization

Name: v3-mcp-optimization
Author: spencermarx

301stars24forks

How to install v3-mcp-optimization?

spencermarx/open-code-review/v3-mcp-optimization

$npx -y skills add spencermarx/open-code-review --skill v3-mcp-optimization

Installs into the current project.

Summary

MCP server optimization and transport layer enhancement for claude-flow v3. Implements connection pooling, load balancing, tool registry optimization, and performance monitoring for sub-100ms response times.

Files · 1

View on GitHub

SKILL.md

1	# V3 MCP Optimization
2
3	## What This Skill Does
4
5	Optimizes claude-flow v3 MCP (Model Context Protocol) server implementation with advanced transport layer optimizations, connection pooling, load balancing, and comprehensive performance monitoring to achieve sub-100ms response times.
6
7	## Quick Start
8
9	```bash
10	# Initialize MCP optimization analysis
11	Task("MCP architecture", "Analyze current MCP server performance and bottlenecks", "mcp-specialist")
12
13	# Optimization implementation (parallel)
14	Task("Connection pooling", "Implement MCP connection pooling and reuse", "mcp-specialist")
15	Task("Load balancing", "Add dynamic load balancing for MCP tools", "mcp-specialist")
16	Task("Transport optimization", "Optimize transport layer performance", "mcp-specialist")
17	```
18
19	## MCP Performance Architecture
20
21	### Current State Analysis
22	```
23	Current MCP Issues:
24	├── Cold Start Latency: ~1.8s MCP server init
25	├── Connection Overhead: New connection per request
26	├── Tool Registry: Linear search O(n) for 213+ tools
27	├── Transport Layer: No connection reuse
28	└── Memory Usage: No cleanup of idle connections
29
30	Target Performance:
31	├── Startup Time: <400ms (4.5x improvement)
32	├── Tool Lookup: <5ms (O(1) hash table)
33	├── Connection Reuse: 90%+ connection pool hits
34	├── Response Time: <100ms p95
35	└── Memory Efficiency: 50% reduction
36	```
37
38	### MCP Server Architecture
39	```typescript
40	// src/core/mcp/mcp-server.ts
41	import { Server } from '@modelcontextprotocol/sdk/server/index.js';
42	import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
43
44	interface OptimizedMCPConfig {
45	// Connection pooling
46	maxConnections: number;
47	idleTimeoutMs: number;
48	connectionReuseEnabled: boolean;
49
50	// Tool registry
51	toolCacheEnabled: boolean;
52	toolIndexType: 'hash' \| 'trie';
53
54	// Performance
55	requestTimeoutMs: number;
56	batchingEnabled: boolean;
57	compressionEnabled: boolean;
58
59	// Monitoring
60	metricsEnabled: boolean;
61	healthCheckIntervalMs: number;
62	}
63
64	export class OptimizedMCPServer {
65	private server: Server;
66	private connectionPool: ConnectionPool;
67	private toolRegistry: FastToolRegistry;
68	private loadBalancer: MCPLoadBalancer;
69	private metrics: MCPMetrics;
70
71	constructor(config: OptimizedMCPConfig) {
72	this.server = new Server({
73	name: 'claude-flow-v3',
74	version: '3.0.0'
75	}, {
76	capabilities: {
77	tools: { listChanged: true },
78	resources: { subscribe: true, listChanged: true },
79	prompts: { listChanged: true }
80	}
81	});
82
83	this.connectionPool = new ConnectionPool(config);
84	this.toolRegistry = new FastToolRegistry(config.toolIndexType);
85	this.loadBalancer = new MCPLoadBalancer();
86	this.metrics = new MCPMetrics(config.metricsEnabled);
87	}
88
89	async start(): Promise<void> {
90	// Pre-warm connection pool
91	await this.connectionPool.preWarm();
92
93	// Pre-build tool index
94	await this.toolRegistry.buildIndex();
95
96	// Setup request handlers with optimizations
97	this.setupOptimizedHandlers();
98
99	// Start health monitoring
100	this.startHealthMonitoring();
101
102	// Start server
103	const transport = new StdioServerTransport();
104	await this.server.connect(transport);
105
106	this.metrics.recordStartup();
107	}
108	}
109	```
110
111	## Connection Pool Implementation
112
113	### Advanced Connection Pooling
114	```typescript
115	// src/core/mcp/connection-pool.ts
116	interface PooledConnection {
117	id: string;
118	connection: MCPConnection;
119	lastUsed: number;
120	usageCount: number;
121	isHealthy: boolean;
122	}
123
124	export class ConnectionPool {
125	private pool: Map<string, PooledConnection> = new Map();
126	private readonly config: ConnectionPoolConfig;
127	private healthChecker: HealthChecker;
128
129	constructor(config: ConnectionPoolConfig) {
130	this.config = {
131	maxConnections: 50,
132	minConnections: 5,
133	idleTimeoutMs: 300000, // 5 minutes
134	maxUsageCount: 1000,
135	healthCheckIntervalMs: 30000,
136	...config
137	};
138
139	this.healthChecker = new HealthChecker(this.config.healthCheckIntervalMs);
140	}
141
142	async getConnection(endpoint: string): Promise<MCPConnection> {
143	const start = performance.now();
144
145	// Try to get from pool first
146	const pooled = this.findAvailableConnection(endpoint);
147	if (pooled) {
148	pooled.lastUsed = Date.now();
149	pooled.usageCount++;
150
151	this.recordMetric('pool_hit', performance.now() - start);
152	return pooled.connection;
153	}
154
155	// Check pool capacity
156	if (this.pool.size >= this.config.maxConnections) {
157	await this.evictLeastUsedConnection();
158	}
159
160	// Create new connection
161	const connection = await this.createConnection(endpoint);
162	const pooledConn: PooledConnection = {
163	id: this.generateConnectionId(),
164	connection,
165	lastUsed: Date.now(),
166	usageCount: 1,
167	isHealthy: true
168	};

People who liked this also viewed

6 picks

Type

v3-mcp-optimization

301stars24forks

View on GitHub

How to install v3-mcp-optimization?

spencermarx/open-code-review/v3-mcp-optimization

$npx -y skills add spencermarx/open-code-review --skill v3-mcp-optimization

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# V3 MCP Optimization
2
3	## What This Skill Does
4
5	Optimizes claude-flow v3 MCP (Model Context Protocol) server implementation with advanced transport layer optimizations, connection pooling, load balancing, and comprehensive performance monitoring to achieve sub-100ms response times.
6
7	## Quick Start
8
9	```bash
10	# Initialize MCP optimization analysis
11	Task("MCP architecture", "Analyze current MCP server performance and bottlenecks", "mcp-specialist")
12
13	# Optimization implementation (parallel)
14	Task("Connection pooling", "Implement MCP connection pooling and reuse", "mcp-specialist")
15	Task("Load balancing", "Add dynamic load balancing for MCP tools", "mcp-specialist")
16	Task("Transport optimization", "Optimize transport layer performance", "mcp-specialist")
17	```
18
19	## MCP Performance Architecture
20
21	### Current State Analysis
22	```
23	Current MCP Issues:
24	├── Cold Start Latency: ~1.8s MCP server init
25	├── Connection Overhead: New connection per request
26	├── Tool Registry: Linear search O(n) for 213+ tools
27	├── Transport Layer: No connection reuse
28	└── Memory Usage: No cleanup of idle connections
29
30	Target Performance:
31	├── Startup Time: <400ms (4.5x improvement)
32	├── Tool Lookup: <5ms (O(1) hash table)
33	├── Connection Reuse: 90%+ connection pool hits
34	├── Response Time: <100ms p95
35	└── Memory Efficiency: 50% reduction
36	```
37
38	### MCP Server Architecture
39	```typescript
40	// src/core/mcp/mcp-server.ts
41	import { Server } from '@modelcontextprotocol/sdk/server/index.js';
42	import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
43
44	interface OptimizedMCPConfig {
45	// Connection pooling
46	maxConnections: number;
47	idleTimeoutMs: number;
48	connectionReuseEnabled: boolean;
49
50	// Tool registry
51	toolCacheEnabled: boolean;
52	toolIndexType: 'hash' \| 'trie';
53
54	// Performance
55	requestTimeoutMs: number;
56	batchingEnabled: boolean;
57	compressionEnabled: boolean;
58
59	// Monitoring
60	metricsEnabled: boolean;
61	healthCheckIntervalMs: number;
62	}
63
64	export class OptimizedMCPServer {
65	private server: Server;
66	private connectionPool: ConnectionPool;
67	private toolRegistry: FastToolRegistry;
68	private loadBalancer: MCPLoadBalancer;
69	private metrics: MCPMetrics;
70
71	constructor(config: OptimizedMCPConfig) {
72	this.server = new Server({
73	name: 'claude-flow-v3',
74	version: '3.0.0'
75	}, {
76	capabilities: {
77	tools: { listChanged: true },
78	resources: { subscribe: true, listChanged: true },
79	prompts: { listChanged: true }
80	}
81	});
82
83	this.connectionPool = new ConnectionPool(config);
84	this.toolRegistry = new FastToolRegistry(config.toolIndexType);
85	this.loadBalancer = new MCPLoadBalancer();
86	this.metrics = new MCPMetrics(config.metricsEnabled);
87	}
88
89	async start(): Promise<void> {
90	// Pre-warm connection pool
91	await this.connectionPool.preWarm();
92
93	// Pre-build tool index
94	await this.toolRegistry.buildIndex();
95
96	// Setup request handlers with optimizations
97	this.setupOptimizedHandlers();
98
99	// Start health monitoring
100	this.startHealthMonitoring();
101
102	// Start server
103	const transport = new StdioServerTransport();
104	await this.server.connect(transport);
105
106	this.metrics.recordStartup();
107	}
108	}
109	```
110
111	## Connection Pool Implementation
112
113	### Advanced Connection Pooling
114	```typescript
115	// src/core/mcp/connection-pool.ts
116	interface PooledConnection {
117	id: string;
118	connection: MCPConnection;
119	lastUsed: number;
120	usageCount: number;
121	isHealthy: boolean;
122	}
123
124	export class ConnectionPool {
125	private pool: Map<string, PooledConnection> = new Map();
126	private readonly config: ConnectionPoolConfig;
127	private healthChecker: HealthChecker;
128
129	constructor(config: ConnectionPoolConfig) {
130	this.config = {
131	maxConnections: 50,
132	minConnections: 5,
133	idleTimeoutMs: 300000, // 5 minutes
134	maxUsageCount: 1000,
135	healthCheckIntervalMs: 30000,
136	...config
137	};
138
139	this.healthChecker = new HealthChecker(this.config.healthCheckIntervalMs);
140	}
141
142	async getConnection(endpoint: string): Promise<MCPConnection> {
143	const start = performance.now();
144
145	// Try to get from pool first
146	const pooled = this.findAvailableConnection(endpoint);
147	if (pooled) {
148	pooled.lastUsed = Date.now();
149	pooled.usageCount++;
150
151	this.recordMetric('pool_hit', performance.now() - start);
152	return pooled.connection;
153	}
154
155	// Check pool capacity
156	if (this.pool.size >= this.config.maxConnections) {
157	await this.evictLeastUsedConnection();
158	}
159
160	// Create new connection
161	const connection = await this.createConnection(endpoint);
162	const pooledConn: PooledConnection = {
163	id: this.generateConnectionId(),
164	connection,
165	lastUsed: Date.now(),
166	usageCount: 1,
167	isHealthy: true
168	};

People who liked this also viewed

6 picks

Type