# optics-mcp

Connects your AI coding assistant to the Sunex lens and image sensor catalog. Handy when matching camera optics to sensor dimensions during hardware design.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: Sunex-AI
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Sunex-AI/Optics-mcp
- Updated: 2026-04-30
- HTML: https://affpapa.org/en/nevibecode/mcp/optics-mcp

## What it does

This MCP server queries Sunex optics data directly from the model prompt. Five bundled tools handle sensor lookups, compute sensor geometry in millimeters, and filter lenses by optical circle or field of view. The agent can quickly check which lens covers a given pixel count and pitch.

The project runs as a lightweight Cloudflare Worker proxying requests to the public `optics-online.com` catalog API. It is completely read-only and requires zero authentication tokens. Communication relies on streamable HTTP via `https://mcp.sunex-ai.com/mcp` or legacy SSE on `/sse`.

## Requirements
- Remote server: `https://mcp.sunex-ai.com/sse`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport sse optics-mcp https://mcp.sunex-ai.com/sse
```

### Codex

**Codex**
- Codex connects MCP servers over stdio and streamable HTTP only, and this server speaks SSE

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "optics-mcp": {
            "url": "https://mcp.sunex-ai.com/sse"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "optics-mcp": {
            "type": "sse",
            "url": "https://mcp.sunex-ai.com/sse"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t sse optics-mcp https://mcp.sunex-ai.com/sse
```

## When to use it
- match compatible lenses to a chosen CMOS sensor model
- calculate optical sensor height, width, and diagonal dimensions
- filter lenses by aperture, field of view, or price limit
- pull sample pricing and request-for-quote links for optical parts

## Example prompts
- Suggest a fast wide-angle lens with F/2.0 or lower for Sony IMX577.
- Calculate the sensor diagonal in millimeters for IMX477.
- Search for fisheye lenses priced under 100 dollars.

## Similar
- [Zotero MCP](https://affpapa.org/en/nevibecode/mcp/zotero-mcp.md) — MCP server · ★ 5585
- [arxiv-mcp-server](https://affpapa.org/en/nevibecode/mcp/arxiv-mcp-server.md) — MCP server · ★ 3235
- [PaperBanana](https://affpapa.org/en/nevibecode/mcp/paperbanana.md) — MCP server · ★ 2418
- [MATLAB MCP Server](https://affpapa.org/en/nevibecode/mcp/matlab-mcp-server.md) — MCP server · ★ 1723
- [Hex Research](https://affpapa.org/en/nevibecode/mcp/hex-research.md) — MCP server · ★ 584
- [DocsAgent — Zotero, Obsidian & Apple Notes MCP Server](https://affpapa.org/en/nevibecode/mcp/docsagent-zotero-obsidian-apple-notes-mcp-server.md) — MCP server · ★ 578

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md