{
  "markdown": "# Image Recognition MCP Server\n\nA Model Context Protocol (MCP) server that provides AI-powered image recognition and description capabilities using OpenAI's vision models.\n\n## Overview\n\nThis MCP server enables AI assistants to analyze and describe images through a simple URL-based interface. It leverages OpenAI's powerful vision models to provide detailed descriptions of images, making it easy to integrate image analysis capabilities into your AI workflows.\n\n## Features\n\n- **Image Analysis**: Analyze images from URLs and get detailed descriptions\n- **OpenAI Integration**: Uses OpenAI's latest vision models for accurate image recognition\n- **MCP Protocol**: Fully compatible with the Model Context Protocol standard\n- **TypeScript**: Built with TypeScript for type safety and better development experience\n- **Simple API**: Easy-to-use interface for image description requests\n\n## Installation\n\n### Prerequisites\n\n- Node.js 18+\n- npm or yarn\n- OpenAI API key\n\n### MCP Client Configuration\n\nTo use this server with an MCP client, add the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"image-recognition\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mcp-s/image-recognition-mcp\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-actual-openai-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n**⚠️ IMPORTANT:** The `env` section with your OpenAI API key is required - this is the only way the MCP server can function.\n\n## Usage\n\n### Available Tools\n\n#### `describe-image`\n\nAnalyzes an image from a URL and provides a detailed description.\n\n**Parameters:**\n\n- `imageUrl` (string): The URL of the image to analyze\n\n**Example:**\n\n```json\n{\n  \"tool\": \"describe-image\",\n  \"arguments\": {\n    \"imageUrl\": \"https://example.com/image.jpg\"\n  }\n}\n```\n\n**Response:**\n\n```json\n{\n  \"content\": [\n    {\n      \"type\": \"text\",\n      \"text\": \"The image shows a beautiful sunset over a mountain landscape with vibrant orange and pink colors in the sky...\"\n    }\n  ]\n}\n```\n\n### Integration with AI Assistants\n\nThis MCP server can be integrated with various AI assistants that support the MCP protocol, such as:\n\n- Claude Desktop\n- Other MCP-compatible AI systems\n\n## Development\n\n### Project Structure\n\n```\nimage-recognition-mcp/\n├── src/\n│   └── index.ts          # Main server implementation\n├── dist/                 # Compiled JavaScript output\n├── package.json          # Project dependencies and scripts\n├── tsconfig.json         # TypeScript configuration\n└── README.md            # This file\n```\n\n### Error Handling\n\nThe server includes robust error handling for:\n\n- Invalid image URLs\n- Network connectivity issues\n- OpenAI API errors\n- Invalid input parameters\n\n## Troubleshooting\n\n### Common Issues\n\n**Server fails to start or doesn't work:**\n\n- ✅ **Check if OpenAI API key is set**: This is the #1 cause of issues\n  ```bash\n  echo $OPENAI_API_KEY  # Should show your API key\n  ```\n- ✅ **Verify API key is valid**: Test with OpenAI's API directly\n- ✅ **Check API key has sufficient credits**: Ensure your OpenAI account has available credits\n\n**\"Authentication failed\" errors:**\n\n- The OpenAI API key is missing or invalid\n- Set the environment variable: `export OPENAI_API_KEY=\"your-key\"`\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the ISC License. See the `LICENSE` file for details.\n\n## Support\n\nFor support, please open an issue in the GitHub repository or contact the maintainer.\n",
  "bytes": 3655,
  "sha": "7f2a009558b698f91fccf202583d8153c29c81dc6e9b5740da1abecfbed80e6f",
  "repo_slug": "mcp-s-ai/image-recognition-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_shalevshalit_image_recognition_b834b475/readme"
}