Civitai MCP Server

Instructions

Implementation Reference

• src/index.ts:630-647 (handler)

  MCP tool handler that executes the search_models_by_creator tool: calls client method, formats results into markdown text response.

  private async searchModelsByCreator(args: any) {
    const response = await this.client.searchModelsByCreator(args.username, args);
    const formatted = this.formatModelsResponse(response);
    
    return {
      content: [
        {
          type: 'text',
          text: `# Models by ${args.username}\\n\\n${formatted.models.map((model: any) => 
            `**${model.name}** (${model.type})\\n` +
            `Downloads: ${model.stats.downloads.toLocaleString()} | Rating: ${model.stats.rating.toFixed(1)}\\n` +
            `Tags: ${model.tags.join(', ')}\\n` +
            `${model.description}\\n\\n`
          ).join('---\\n')}`,
        },
      ],
    };
  }

• src/index.ts:275-291 (schema)

  Tool schema definition including input schema with required 'username' and optional limit/sort parameters.

  {
    name: 'search_models_by_creator',
    description: 'Search for models by a specific creator',
    inputSchema: {
      type: 'object',
      properties: {
        username: { type: 'string', description: 'Creator username to search for' },
        limit: { type: 'number', description: 'Number of models to return (default: 20)', minimum: 1, maximum: 100 },
        sort: { 
          type: 'string', 
          enum: ['Highest Rated', 'Most Downloaded', 'Newest'],
          description: 'Sort order for results'
        },
      },
      required: ['username'],
    },
  },

• src/index.ts:71-72 (registration)

  Tool dispatching/registration in the CallToolRequest handler switch statement.

  case 'search_models_by_creator':
    return await this.searchModelsByCreator(args);

• src/civitai-client.ts:168-170 (helper)

  Client helper method that calls Civitai API's getModels with 'username' filter parameter.

  async searchModelsByCreator(username: string, options: Partial<ModelsParams> = {}): Promise<ModelsResponse> {
    return this.getModels({ username, ...options });
  }