Civitai MCP Server

Instructions

Implementation Reference

• src/index.ts:449-475 (handler)

  Executes the tool logic: fetches model version via client and formats response as formatted text content.

  private async getModelVersion(args: any) {
    const { modelVersionId } = args;
    const version = await this.client.getModelVersion(modelVersionId);
    
    return {
      content: [
        {
          type: 'text',
          text: `# ${version.model.name} - ${version.name}\\n\\n` +
            `**Model Type:** ${version.model.type}\\n` +
            `**Version ID:** ${version.id}\\n` +
            `**Created:** ${new Date(version.createdAt).toLocaleDateString()}\\n` +
            `**Downloads:** ${version.stats.downloadCount?.toLocaleString() || 0}\\n` +
            `**Rating:** ${version.stats.rating?.toFixed(1) || 'N/A'}\\n\\n` +
            `**Trained Words:** ${version.trainedWords.join(', ') || 'None'}\\n\\n` +
            `**Description:**\\n${version.description}\\n\\n` +
            `**Files (${version.files?.length || 0}):**\\n${version.files?.map(file => 
              `- Size: ${file.sizeKb ? (file.sizeKb / 1024).toFixed(1) : 'Unknown'} MB\\n` +
              `  Format: ${file.metadata?.format || 'Unknown'}\\n` +
              `  FP: ${file.metadata?.fp || 'Unknown'}\\n` +
              `  Scans: Pickle=${file.pickleScanResult || 'Unknown'}, Virus=${file.virusScanResult || 'Unknown'}\\n`
            ).join('\\n') || 'No files available'}\\n` +
            `**Sample Images:** ${version.images.length} available`,
        },
      ],
    };
  }

• src/index.ts:142-152 (registration)

  Tool registration in the getTools() method, defining name, description, and input schema.

  {
    name: 'get_model_version',
    description: 'Get detailed information about a specific model version',
    inputSchema: {
      type: 'object',
      properties: {
        modelVersionId: { type: 'number', description: 'The ID of the model version to retrieve' },
      },
      required: ['modelVersionId'],
    },
  },

• src/index.ts:145-151 (schema)

  Input schema defining the required modelVersionId parameter.

  inputSchema: {
    type: 'object',
    properties: {
      modelVersionId: { type: 'number', description: 'The ID of the model version to retrieve' },
    },
    required: ['modelVersionId'],
  },

• src/index.ts:53-54 (handler)

  Dispatch handler in the CallToolRequestSchema switch statement.

  case 'get_model_version':
    return await this.getModelVersion(args);

• src/civitai-client.ts:129-132 (helper)

  CivitaiClient helper method that makes the API request to fetch model version data.

  async getModelVersion(modelVersionId: number): Promise<ModelVersionResponse> {
    const url = this.buildUrl(`/model-versions/${modelVersionId}`);
    return this.makeRequest<ModelVersionResponse>(url, ModelVersionResponseSchema);
  }