Kobold MCP Server

Instructions

Implementation Reference

• src/index.ts:307-324 (handler)

  Handler logic that maps 'kobold_model_info' tool name to the KoboldAI API endpoint '/api/v1/model' and performs a GET request to retrieve the model information.

  const getEndpoints: Record<string, string> = {
      kobold_max_context_length: '/api/v1/config/max_context_length',
      kobold_max_length: '/api/v1/config/max_length',
      kobold_generate_check: '/api/extra/generate/check',
      kobold_model_info: '/api/v1/model',
      kobold_version: '/api/v1/info/version',
      kobold_perf_info: '/api/extra/perf',
      kobold_sd_models: '/sdapi/v1/sd-models',
      kobold_sd_samplers: '/sdapi/v1/samplers',
  };
  
  if (getEndpoints[name]) {
      const result = await makeRequest(`${apiUrl}${getEndpoints[name]}`);
      return {
          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
          isError: false,
      };
  }

• src/index.ts:183-187 (registration)

  Registration of the 'kobold_model_info' tool in the ListTools response, including its name, description, and input schema derived from ModelInfoSchema.

  {
      name: "kobold_model_info",
      description: "Get current model information",
      inputSchema: zodToJsonSchema(ModelInfoSchema),
  },

• src/index.ts:71-71 (schema)

  Definition of the ModelInfoSchema, which is used as the input schema for the kobold_model_info tool and aliases the shared BaseConfigSchema.

  const ModelInfoSchema = BaseConfigSchema;

• src/index.ts:11-13 (schema)

  BaseConfigSchema defining the common input structure (apiUrl) used by ModelInfoSchema and many other tools.

  const BaseConfigSchema = z.object({
      apiUrl: z.string().default('http://localhost:5001'),
  });

• src/index.ts:146-162 (helper)

  makeRequest utility function that performs HTTP requests to the KoboldAI API, used by the handler for kobold_model_info.

  async function makeRequest(url: string, method = 'GET', body: Record<string, unknown> | null = null) {
      const options: RequestInit = {
          method,
          headers: body ? { 'Content-Type': 'application/json' } : undefined,
      };
      
      if (body && method !== 'GET') {
          options.body = JSON.stringify(body);
      }
  
      const response = await fetch(url, options);
      if (!response.ok) {
          throw new Error(`KoboldAI API error: ${response.statusText}`);
      }
      
      return response.json();
  }