What it does
Design, simulate and optimize optical thin-film coatings with the OpenFilters engine.
- Connects Se ejecuta en tu computadora
- Account or key No key needed
- Category Juegos, deportes, comida y aprendizaje
Por qué está en este puesto
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 23/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 35/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Instalación
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala MCP for OpenFilters. Sigue https://mcp.popnx.com/i/bbrunoesteves-mcp-for-openfilters.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Que la IA lo instale
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server MCP for OpenFilters para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "for-openfilters": { "command": "uvx", "args": [ "mcp-for-openfilters" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP for OpenFilters aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Pega esta configuración y guarda el archivo
{ "mcpServers": { "for-openfilters": { "command": "uvx", "args": [ "mcp-for-openfilters" ] } } }Cierra Claude y vuelve a abrirlo
Pruébalo
Usa MCP for OpenFilters y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando MCP for OpenFilters o muestra una herramienta de MCP for OpenFilters en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar MCP for OpenFilters
MCP for OpenFilters se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
Lo que puedes hacer en su lugar
A · Usa una app que pueda conectar MCP for OpenFilters
- Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
- Instala Python (uv) en tu computadora primero (una sola vez)
- Instala Python (uv) en tu computadora primero (una sola vez)
- Instala Python (uv) en tu computadora primero (una sola vez)
B · Otros en Juegos, deportes, comida y aprendizaje que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
- ShipSwift✓ ChatGPT
- Anime Garden✓ ChatGPT
- Summer Engine✓ ChatGPT
Funciona con Claude Code, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server MCP for OpenFilters para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user for-openfilters -- uvx mcp-for-openfilters 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP for OpenFilters aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Pega este comando y pulsa Enter
claude mcp add --scope user for-openfilters -- uvx mcp-for-openfiltersEscribe /mcp en Claude Code
Deberías ver MCP for OpenFilters en la lista como conectado
Pruébalo
Usa MCP for OpenFilters y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando MCP for OpenFilters o muestra una herramienta de MCP for OpenFilters en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server MCP for OpenFilters para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "for-openfilters": { "command": "uvx", "args": [ "mcp-for-openfilters" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP for OpenFilters aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Abre el chat de IA de Cursor en modo Agent
Pruébalo
Usa MCP for OpenFilters y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando MCP for OpenFilters o muestra una herramienta de MCP for OpenFilters en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server MCP for OpenFilters para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "for-openfilters": { "type": "stdio", "command": "uvx", "args": [ "mcp-for-openfilters" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP for OpenFilters aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Abre el chat de IA de VS Code en modo Agent
Pruébalo
Usa MCP for OpenFilters y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando MCP for OpenFilters o muestra una herramienta de MCP for OpenFilters en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Para desarrolladores: comandos de Terminal y configuración JSON
Instalado en tu computadora
Claude Code
claude mcp add --scope user for-openfilters -- uvx mcp-for-openfiltersClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"for-openfilters": {
"command": "uvx",
"args": [
"mcp-for-openfilters"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"for-openfilters": {
"command": "uvx",
"args": [
"mcp-for-openfilters"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"for-openfilters": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-for-openfilters"
]
}
}
}Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
De un vistazo
Qué apps pueden usarlo
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Qué puede hacer
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisiones básicasi
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
- ✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub BBrunoEsteves, dueña del repo
- ✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 12 días
- ✓ Superada
Tiene licencia
Usa GPL-2.0
- – No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
- – No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
- … Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Vulnerabilidades publicadas (OSV.dev)
Sin entradas en OSV.dev para mcp-for-openfilters@0.2.2
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/bbrunoesteves-mcp-for-openfilters)Conversación
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Reseñas de usuarios
Aún no hay reseñas
Comparado con otros en Juegos, deportes, comida y aprendizajei
- Más estrellas que el 0% de los otros 1611 servidores de esta categoría
- Publicado en el registro más recientemente que el 69% de los otros 1611 servidores de esta categoría
- Revisiones básicas iguales o mejores que el 99% de los otros 1611 servidores de esta categoría
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Preguntas frecuentes
¿Es seguro MCP for OpenFilters?
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
¿Qué claves o códigos necesita?
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
¿Se ejecuta en mi computadora o en la nube?
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
¿Sigue en mantenimiento?
El repo de GitHub cambió por última vez hace 12 días, y la última versión (0.2.2) llegó al registro hace 12 días.
¿Qué apps pueden usarlo?
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
¿Qué puedo usar en su lugar?
En la misma categoría: Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch
Alternativas parecidas
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
WilmAI
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Lumify Sports Intelligence
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft
Savecraft serves real save game data and expert game knowledge to AI assistants.
GoodWatch
Find movies and TV shows, track watches, and get suggestions based on your taste.
| Este MCP for OpenFilters | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | GoodWatch | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | No | No | No | Sí | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 4/4 | 3/4 | 4/4 |
| Licencia | GPL-2.0 | AGPL-3.0 | MIT | MIT | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
README del creador
Abrir el README
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
MCP for OpenFilters
*An unofficial connector built on OpenFilters: not affiliated with or endorsed by the OpenFilters authors or Polytechnique Montréal.*
Design, simulate and optimize optical thin-film coatings by talking to Claude.
This project is an MCP server around the calculation core of [OpenFilters](https://www.polymtl.ca/larfis/en/links) (Stéphane Larouche and Ludvik Martinu, Polytechnique Montréal), ported to Python 3 and run without its GUI. Claude plans the work and reads compact summaries; the server does the computing — in parallel on all CPU cores — and writes full results to disk, including .ofp project files that open in the OpenFilters GUI.
Claude orchestrates; the server computes. One tool call can launch a whole campaign.
Quick start
Pick the one that matches how you use Claude (details under Installation):
| You use | Do this |
|---|---|
| Claude Desktop | Download mcp-for-openfilters- .mcpb from the latest release and open it: Claude Desktop installs the extension. |
| Claude Code | claude mcp add --scope user mcp-for-openfilters -- uvx mcp-for-openfilters (needs uv), or the plugin: /plugin marketplace add BBrunoEsteves/mcp-for-openfilters, then /plugin install mcp-for-openfilters@mcp-for-openfilters |
| Any MCP client, or no uv | Run uvx mcp-for-openfilters, pip install mcp-for-openfilters (PyPI), or the installer from the release page, which also registers it in Claude Desktop and Claude Code. |
Then, in a new chat: *"Run the MCP for OpenFilters server_info tool"*, and try *"Design an antireflection coating for BK7 from 430 to 670 nm with TiO2 and SiO2."* It is also listed in the official MCP Registry as io.github.BBrunoEsteves/mcp-for-openfilters.
Built and tested with Claude. The server follows the open MCP standard, but it has so far been
developed and tested only with Claude (Claude Desktop and Claude Code). Other MCP clients may work,
but they are untested: tool descriptions, plots and long-running jobs may behave differently there.
What it can do
| Area | Tools |
|---|---|
| Materials | list_materials, get_material_index, add_material (constant, Cauchy, Sellmeier, n,k tables from files), search_refractiveindex + import_refractiveindex_material (any of the ~3,500 entries of the refractiveindex.info database, downloaded on demand) |
| Single design | describe_design, compute_spectrum (R/T/A, phase, GD, GDD; s/p/unpolarized or any polarization angle; any angle of incidence; reverse side), compute_angle_scan, compute_color, compute_electric_field, compute_monitoring_curves (chosen wavelengths or spectroscopic; reverse side) |
| Targets & merit | evaluate_design, layer_sensitivity |
| Optimization | optimize_design — OpenFilters' refinement, needle and step methods |
| Temperature | thermal_sensitivity (how a peak moves per index and thickness change of each material; dλ/dT, kelvin per FWHM, athermal dn/dT), thermal_sweep (peak versus temperature) — tunable and athermal filters |
| Campaigns | run_batch (parameter sweeps), run_optimization_campaign (many starts → ranked → optional yield stage), tolerance_analysis (Monte Carlo yield with thickness and index errors), simulate_random_errors (OpenFilters' Preproduction: mean, standard deviation and worst case of the curves) |
| Jobs | job_status, get_results, list_jobs, cancel_job — results survive a server restart |
| Files | load_project, save_project (native .ofp) |
Example requests to Claude:
- *"Design a dichroic on BK7 with R > 99 % at 532 and 1064 nm and T > 90 % at 633 nm for 0–20°, at most 40 layers of TiO2/SiO2. Run 100 needle optimizations from random starts and rank the best 10 by yield at ±1 % thickness error."*
- *"Add my ALD Al2O3 from this ellipsometry file and sweep the AR coating thickness ±10 %."*
- *"Find thin-film HfO2 data on refractiveindex.info, import it and redo the mirror with it."*
- *"Where is the electric-field peak of this mirror at 1064 nm, and what monitoring signal should I expect at 633 nm at the end of each layer?"*
Ready-made workflows (prompts) appear as / commands in Claude Code and in the attachment menu of Claude Desktop: design an antireflection coating, a mirror, an edge filter or dichroic, a narrow band-pass filter, and review a design for manufacturing. The design-format guide, the material list and the OpenFilters example projects are available as resources (openfilters://guide, openfilters://materials, openfilters://examples/ ). Long optimizations and yield analyses report progress to apps that show it.
Installation
Requires Python ≥ 3.10. OpenFilters itself does not need to be installed: its calculation engine is built in (the OpenFilters GUI is only useful to open the .ofp files).
Claude Desktop extension (one click)
From the latest release, download mcp-for-openfilters- .mcpb and open it (or drag it onto Claude Desktop's Settings → Extensions). Claude Desktop runs it with uv, which fetches the server from PyPI.
Claude Code plugin
In Claude Code:
/plugin marketplace add BBrunoEsteves/mcp-for-openfilters
/plugin install mcp-for-openfilters@mcp-for-openfilters
The plugin runs the server with uvx (see claude-plugin/README.md for what it runs and downloads).
With uv (one command)
With uv installed, the server runs straight from PyPI, with the right package for your computer chosen automatically:
claude mcp add --scope user mcp-for-openfilters -- uvx mcp-for-openfilters
For Claude Desktop, add to claude_desktop_config.json (Settings → Developer → Edit config), then fully quit and reopen Claude Desktop:
{"mcpServers": {"mcp-for-openfilters": {"command": "uvx", "args": ["mcp-for-openfilters"]}}}
uvx keeps its own cached environment; uvx mcp-for-openfilters@latest picks up a new version.
With the installer
From the release page, download install_mcp_for_openfilters.py and the package for your computer (or all .whl files) into one folder, then:
python install_mcp_for_openfilters.py
It creates a private environment in ~/.mcp-for-openfilters, installs the package, registers the server in Claude Desktop (backing up its settings) and Claude Code, and runs a self-test. Then fully quit and reopen Claude Desktop. --uninstall removes it; --from-github downloads the packages with the GitHub CLI.
Packages are built for Windows (64-bit), Linux (x86-64) and macOS (Apple Silicon), Python 3.10–3.14, with the compiled fast core included: no compiler needed.
Manually
pip install mcp_for_openfilters-<version>-<python>-<platform>.whl
claude mcp add --scope user mcp-for-openfilters -- mcp-for-openfilters
For Claude Desktop, add to claude_desktop_config.json (Settings → Developer → Edit config):
{"mcpServers": {"mcp-for-openfilters": {"command": "<full path to mcp-for-openfilters>"}}}
Upgrading from openfilters-mcp (before 0.2.0)
The project was called *openfilters-mcp* until version 0.2.0. Fully quit Claude Desktop and Claude Code, then run the new installer: it removes the old openfilters registration and the old private environment (~/.openfilters-mcp) and registers mcp-for-openfilters. Your data folder ~/OpenFilters-MCP is kept and still used, and the old OPENFILTERS_MCP_* environment variables are still read. After a manual install, pip uninstall openfilters-mcp and replace the openfilters entry in your Claude settings.
From source (development)
git clone https://github.com/BBrunoEsteves/mcp-for-openfilters
cd mcp-for-openfilters python -m venv .venv .venv/Scripts/pip install -e ".[dev]" # .venv/bin/pip on macOS/Linux python dev/fetch_compiled.py # fast C++ core compiled by GitHub Actions (or build it locally)
Configuration
| Environment variable | Default | Meaning |
|---|---|---|
MCP_FOR_OPENFILTERS_HOME | ~/MCP-for-OpenFilters | data folder: materials/, jobs/, projects/, outputs/ |
MCP_FOR_OPENFILTERS_WORKERS | CPU count − 1 | parallel worker processes for jobs |
The names used before 0.2.0 (OPENFILTERS_MCP_HOME, OPENFILTERS_MCP_WORKERS) still work, and an existing ~/OpenFilters-MCP folder is used when ~/MCP-for-OpenFilters does not exist.
Conventions
- wavelengths and thicknesses in nm, angles in degrees, R/T/A as fractions (0–1);
- complex index N = n − ik (k ≥ 0 absorbs), as in OpenFilters and Macleod;
- layers are listed from the substrate outward;
- the merit function is OpenFilters' χ² = Σ ((target − value)/tolerance)², with satisfied inequality targets contributing zero.
A design:
{"substrate": "FusedSilica", "incident_medium": "void", "center_wavelength": 550,
"layers": [{"material": "TiO2", "thickness": 58.6}, {"material": "SiO2", "qwot": 1}]}
or with a stack formula: {"formula": {"formula": "(HL)^8 H", "materials": {"H": "TiO2", "L": "SiO2"}}}.
Materials given as n,k tables have no data outside their wavelength range. There the design field "table_extrapolation" decides: "hold" (default: n,k stay at the value at the nearest end of the data), "openfilters" (OpenFilters' own extrapolation, identical to its GUI) or "refuse". Every result computed outside the data says so, with the n,k used and what the other choice would give; optimizations, campaigns and yield analyses do not start until the choice is made (Claude asks you).
A target:
{"kind": "R", "from": 1000, "to": 1100, "step": 5, "value": 0.99, "tolerance": 0.005,
"inequality": ">=", "angle": 0, "polarization": "unpolarized"}
Validation
The test suite (pytest) checks the ported core against analytic results (quarter-wave stacks) and an independent transfer-matrix implementation (dispersive dielectrics, absorbing metals, 0–60°, s/p/unpolarized; agreement < 1e-9) and textbook closed forms (quarter-wave antireflection and absentee layers, V-coat zero, Brewster angle, quarter-wave stack peak reflectance and stop-band width), round-trips every example project through .ofp files, and runs the refinement and needle optimizations of the OpenFilters examples.
How the port was made
src/openfilters_core is generated from the original OpenFilters 1.1.1 sources by tools/port_from_py2.py, an auditable script (mechanical Python 2 → 3 conversions, a short list of targeted fixes, package-relative imports). The _abeles C++ extension uses the Python 3 C-API port by Emil Kleijn; _moremath is ported by the same script. See src/openfilters_core/PROVENANCE.md.
Privacy
Everything runs on your computer: no data is sent anywhere and there is no telemetry. The only network access is downloading public refractiveindex.info data when you ask for it. See PRIVACY.md.
Citing
If you use this in published work, please cite OpenFilters:
S. Larouche and L. Martinu, "OpenFilters: open-source software for the design, optimization, and
synthesis of optical filters," *Applied Optics* 47, C219–C230 (2008).
Contact
- Bug reports and feature requests: GitHub Issues (please include the ou