Kobold MCP Server

Instructions

Implementation Reference

• src/index.ts:278-305 (handler)

  Implementation of the kobold_chat tool handler: appends incoming messages to in-memory chat history, sends full history to KoboldAI /v1/chat/completions endpoint (overriding with full history), adds response to history, and returns the API response as text.

  if (name === 'kobold_chat') {
      // Add new messages to chat history
      const newMessages = (requestData as any).messages || [];
      chatHistory.push(...newMessages);
  
      // Get last 4 messages
      const recentMessages = chatHistory.slice(-4);
      console.error('Last 4 messages in chat:');
      console.error(JSON.stringify(recentMessages, null, 2));
  
      // Make the API request with all context
      const result = await makeRequest(
          `${apiUrl}/v1/chat/completions`,
          'POST',
          { ...requestData, messages: chatHistory }
      );
  
      // Add assistant's response to history
      const typedResult = result as any;
      if (typedResult.choices?.[0]?.message) {
          chatHistory.push(typedResult.choices[0].message);
      }
  
      return {
          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
          isError: false,
      };
  }

• src/index.ts:102-111 (schema)

  Zod input schema for kobold_chat tool: OpenAI-compatible chat completion parameters including messages array and optional sampling params.

  const ChatCompletionSchema = BaseConfigSchema.extend({
      messages: z.array(z.object({
          role: z.enum(['system', 'user', 'assistant']),
          content: z.string(),
      })),
      temperature: z.number().optional(),
      top_p: z.number().optional(),
      max_tokens: z.number().optional(),
      stop: z.array(z.string()).optional(),
  });

• src/index.ts:260-264 (registration)

  Registration of the kobold_chat tool in the ListTools response, referencing its schema.

  {
      name: "kobold_chat",
      description: "Chat completion (OpenAI-compatible)",
      inputSchema: zodToJsonSchema(ChatCompletionSchema),
  },

• src/index.ts:37-41 (helper)

  Global in-memory chat history array used exclusively by the kobold_chat handler to maintain conversation context.

  const chatHistory: Array<{
      role: 'system' | 'user' | 'assistant',
      content: string
  }> = [];
  // Generate check schemas