image-mcp-server

README en japonès

Un servidor MCP que rep URL d'imatges o camins de fitxers locals i analitza el contingut de les imatges utilitzant el model GPT-4o-mini.

Features

• Rep URL d'imatges o camins de fitxers locals com a entrada i proporciona una anàlisi detallada del contingut de la imatge
• Reconixement i descripció d'imatges amb alta precisió utilitzant el model GPT-4o-mini
• Verificació de la validesa de les URL d'imatges
• Carregament d'imatges des de fitxers locals i codificació en Base64

Installation

Installing via Smithery

Per instal·lar el Servidor d'Anàlisi d'Imatges per a Claude Desktop automàticament via Smithery:

npx -y @smithery/cli install @champierre/image-mcp-server --client claude

Manual Installation

# Clone the repository
git clone https://github.com/champierre/image-mcp-server.git # or your forked repository
cd image-mcp-server

# Install dependencies
npm install

# Compile TypeScript
npm run build

Configuration

Per utilitzar aquest servidor, necessiteu una clau d'API d'OpenAI. Configureu la següent variable d'entorn:

OPENAI_API_KEY=your_openai_api_key

MCP Server Configuration

Per utilitzar amb eines com Cline, afegiu els següents paràmetres al fitxer de configuració del servidor MCP:

For Cline

Afegiu el següent a cline_mcp_settings.json:

{
  "mcpServers": {
    "image-analysis": {
      "command": "node",
      "args": ["/path/to/image-mcp-server/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key"
      }
    }
  }
}

For Claude Desktop App

Afegiu el següent a claude_desktop_config.json:

{
  "mcpServers": {
    "image-analysis": {
      "command": "node",
      "args": ["/path/to/image-mcp-server/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key"
      }
    }
  }
}

Usage

Un cop el servidor MCP estigui configurat, les següents eines es tornaran disponibles:

• analyze_image: Rep una URL d'imatge i analitza el seu contingut.
• analyze_image_from_path: Rep un camí de fitxer local i analitza el seu contingut.

Usage Examples

Analitzant des de URL:

Please analyze this image URL: https://example.com/image.jpg

Analitzant des d'un camí de fitxer local:

Please analyze this image: /path/to/your/image.jpg

Note: Specifying Local File Paths

Quan s'utilitza l'eina analyze_image_from_path, l'assistent IA (client) ha de especificar un camí de fitxer vàlid en l'entorn on s'executa aquest servidor.

• Si el servidor s'executa a WSL:
  • Si l'assistent IA té un camí de Windows (p. ex., C:\...), ha de convertir-lo a un camí WSL (p. ex., /mnt/c/...) abans de passar-lo a l'eina.
  • Si l'assistent IA té un camí WSL, pot passar-lo tal com és.
• Si el servidor s'executa a Windows:
  • Si l'assistent IA té un camí WSL (p. ex., /home/user/...), ha de convertir-lo a un camí UNC (p. ex., \\wsl$\Distro\...) abans de passar-lo a l'eina.
  • Si l'assistent IA té un camí de Windows, pot passar-lo tal com és.

La conversió de camins és responsabilitat de l'assistent IA (o del seu entorn d'execució). El servidor intentarà interpretar el camí rebut tal com és.

Note: Type Errors During Build

En executar npm run build, podeu veure un error (TS7016) sobre la falta de definicions de tipus TypeScript per al mòdul mime-types.

src/index.ts:16:23 - error TS7016: Could not find a declaration file for module 'mime-types'. ...

Aquest és un error de comprovació de tipus, i com que la compilació de JavaScript es realitza correctament, no afecta l'execució del servidor. Si voleu resoldre aquest error, instal·leu el fitxer de definició de tipus com a dependència de desenvolupament.

npm install --save-dev @types/mime-types
# or
yarn add --dev @types/mime-types

Development

# Run in development mode
npm run dev

License

MIT