Ollama MCP Server

Instructions

Implementation Reference

• src/tools/show.ts:10-18 (handler)

  Core execution logic for the ollama_show tool: calls ollama.show({ model }) to fetch model details and formats the JSON response.

  export async function showModel(
    ollama: Ollama,
    model: string,
    format: ResponseFormat
  ): Promise<string> {
    const response = await ollama.show({ model });
  
    return formatResponse(JSON.stringify(response), format);
  }

• src/tools/show.ts:20-44 (registration)

  ToolDefinition export that defines and registers the ollama_show tool, including its handler, schema, and metadata. Auto-discovered by the autoloader.

  export const toolDefinition: ToolDefinition = {
    name: 'ollama_show',
    description:
      'Show detailed information about a specific model including modelfile, parameters, and architecture details.',
    inputSchema: {
      type: 'object',
      properties: {
        model: {
          type: 'string',
          description: 'Name of the model to show',
        },
        format: {
          type: 'string',
          enum: ['json', 'markdown'],
          description: 'Output format (default: json)',
          default: 'json',
        },
      },
      required: ['model'],
    },
    handler: async (ollama: Ollama, args: Record<string, unknown>, format: ResponseFormat) => {
      const validated = ShowModelInputSchema.parse(args);
      return showModel(ollama, validated.model, format);
    },
  };

• src/schemas.ts:64-67 (schema)

  Zod input validation schema for the ollama_show tool, used in the handler for parsing arguments.

  export const ShowModelInputSchema = z.object({
    model: z.string().min(1),
    format: ResponseFormatSchema.default('json'),
  });

• src/tools/show.ts:24-39 (schema)

  Inline inputSchema in toolDefinition matching the external schema, used for MCP tool listing.

  inputSchema: {
    type: 'object',
    properties: {
      model: {
        type: 'string',
        description: 'Name of the model to show',
      },
      format: {
        type: 'string',
        enum: ['json', 'markdown'],
        description: 'Output format (default: json)',
        default: 'json',
      },
    },
    required: ['model'],
  },