02-mcp-protocol-standards

02-MCP-Protocol-Standards

MCP Protocol Implementation

This project implements the Model Context Protocol (MCP) using @modelcontextprotocol/sdk.

Core MCP Components

• Server: agentify-mcp.ts implements the main MCP server
• Tools: tool-registry.ts manages MCP tool implementations
• Resources: resource-manager.ts handles MCP resource serving

CRITICAL MCP RULES - MUST FOLLOW

✅ ALWAYS DO:

1. Use proper schemas: All tool definitions MUST use proper inputSchema with type, properties, and required fields
2. Validate tool arguments: Always validate incoming tool arguments against the schema
3. Return proper response format: Tools must return objects that match MCP response expectations
4. Handle client detection: Use AgentClientType to provide client-specific tools and resources
5. Implement proper URI schemes: Resources must use agentify:// URI scheme consistently

❌ NEVER DO:

1. Skip input validation: Never execute tools without validating input parameters
2. Return raw strings for complex data: Use structured objects, not plain strings for tool responses
3. Hardcode resource URIs: Always use the established agentify:// URI pattern
4. Ignore client context: Never provide tools/resources without checking client type compatibility
5. Break MCP schema compliance: All responses must conform to MCP protocol specifications

Tool Implementation Standards

Required Tool Structure:

{
  name: string;                    // kebab-case naming
  description: string;             // Clear, actionable description
  inputSchema: {
    type: 'object';
    properties: Record<string, any>; // Detailed parameter definitions
    required?: string[];             // List required parameters
  };
  clientTypes?: AgentClientType[];   // Specify compatible clients
  handler: (args: any, client: AgentClient) => Promise<any>;
}