mcpengine/infra/factory-tools/mcp-validator/schema/mcp_schema_2024-11-05.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://example.com/mcp-schema-2024-11-05.json",
  "title": "MCP Protocol Schema (2024-11-05)",
  "description": "JSON Schema for the MCP (Model Completion Protocol) version 2024-11-05",
  "type": "object",
  "additionalProperties": false,
  "required": ["jsonrpc"],
  "properties": {
    "jsonrpc": {
      "type": "string",
      "const": "2.0",
      "description": "JSON-RPC version, must be 2.0"
    },
    "id": {
      "type": ["string", "number"],
      "description": "Request identifier"
    },
    "method": {
      "type": "string",
      "description": "The method to invoke"
    },
    "params": {
      "type": "object",
      "description": "Method parameters"
    },
    "result": {
      "type": ["object", "array", "string", "number", "boolean", "null"],
      "description": "Result of the method invocation"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "description": "Error code"
        },
        "message": {
          "type": "string",
          "description": "Error message"
        },
        "data": {
          "description": "Additional error data"
        }
      },
      "required": ["code", "message"],
      "description": "Error object"
    }
  },
  "oneOf": [
    {
      "type": "object",
      "required": ["jsonrpc", "method", "params"],
      "description": "A request object"
    },
    {
      "type": "object",
      "required": ["jsonrpc", "method"],
      "not": {
        "required": ["id"]
      },
      "description": "A notification object"
    },
    {
      "type": "object",
      "required": ["jsonrpc", "result", "id"],
      "description": "A successful response object"
    },
    {
      "type": "object",
      "required": ["jsonrpc", "error", "id"],
      "description": "An error response object"
    }
  ],
  "definitions": {
    "initialize_request": {
      "type": "object",
      "required": ["protocolVersion", "capabilities", "clientInfo"],
      "properties": {
        "protocolVersion": {
          "type": "string",
          "description": "The protocol version the client supports"
        },
        "capabilities": {
          "type": "object",
          "description": "The capabilities of the client",
          "properties": {
            "supports": {
              "type": "object",
              "description": "Client-supported capabilities",
              "properties": {
                "filesystem": {
                  "type": "boolean",
                  "description": "Whether the client supports filesystem operations"
                }
              }
            }
          }
        },
        "clientInfo": {
          "type": "object",
          "description": "Information about the client",
          "required": ["name"],
          "properties": {
            "name": {
              "type": "string",
              "description": "Name of the client"
            },
            "version": {
              "type": "string",
              "description": "Version of the client"
            }
          }
        }
      }
    },
    "initialize_response": {
      "type": "object",
      "required": ["protocolVersion", "capabilities", "serverInfo"],
      "properties": {
        "protocolVersion": {
          "type": "string",
          "description": "The protocol version the server selected"
        },
        "capabilities": {
          "type": "object",
          "description": "The capabilities of the server"
        },
        "serverInfo": {
          "type": "object",
          "required": ["name"],
          "properties": {
            "name": {
              "type": "string",
              "description": "Name of the server"
            },
            "version": {
              "type": "string",
              "description": "Version of the server"
            }
          }
        }
      }
    },
    "filesystem_list_directory_request": {
      "type": "object",
      "required": ["path"],
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to list"
        }
      }
    },
    "filesystem_list_directory_response": {
      "type": "object",
      "required": ["entries"],
      "properties": {
        "entries": {
          "type": "array",
          "items": {
            "type": "object",
            "required": ["name", "type"],
            "properties": {
              "name": {
                "type": "string",
                "description": "Name of the entry"
              },
              "type": {
                "type": "string",
                "enum": ["file", "directory"],
                "description": "Type of the entry"
              },
              "size": {
                "type": "integer",
                "description": "Size of the file in bytes (only for files)"
              },
              "modifiedTime": {
                "type": "string",
                "format": "date-time",
                "description": "Last modified time"
              }
            }
          }
        }
      }
    },
    "filesystem_read_file_request": {
      "type": "object",
      "required": ["path"],
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to read"
        }
      }
    },
    "filesystem_read_file_response": {
      "type": "object",
      "required": ["content"],
      "properties": {
        "content": {
          "type": "array",
          "items": {
            "type": "object",
            "required": ["type"],
            "properties": {
              "type": {
                "type": "string",
                "enum": ["text", "binary"],
                "description": "Type of content"
              },
              "text": {
                "type": "string",
                "description": "Text content (only for text type)"
              },
              "base64": {
                "type": "string",
                "description": "Base64-encoded binary content (only for binary type)"
              }
            }
          }
        }
      }
    },
    "filesystem_write_file_request": {
      "type": "object",
      "required": ["path", "content"],
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to write"
        },
        "content": {
          "type": "string",
          "description": "Content to write"
        }
      }
    },
    "filesystem_write_file_response": {
      "type": "object",
      "properties": {
        "bytesWritten": {
          "type": "integer",
          "description": "Number of bytes written"
        }
      }
    },
    "tools_list_request": {
      "type": "object",
      "properties": {}
    },
    "tools_list_response": {
      "type": "object",
      "required": ["tools"],
      "properties": {
        "tools": {
          "type": "array",
          "items": {
            "type": "object",
            "required": ["name", "description"],
            "properties": {
              "name": {
                "type": "string",
                "description": "Name of the tool"
              },
              "description": {
                "type": "string",
                "description": "Description of the tool"
              },
              "parameters": {
                "type": "object",
                "description": "Parameters schema for the tool"
              }
            }
          }
        }
      }
    },
    "tools_call_request": {
      "type": "object",
      "required": ["name", "arguments"],
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the tool to call"
        },
        "arguments": {
          "type": "object",
          "description": "Arguments to pass to the tool"
        }
      }
    }
  }
}