# openfilm-mcp

An MCP server for the **[Openfilm](https://openfilm.cc/) film stock and classic camera datasets** —
68 current and classic film stocks and 60 classic cameras, published as open data under CC BY 4.0.

The data is bundled, so the six search tools work offline. Only the paid `audit_url` tool talks
to the network.

## Tools

| tool | what it does |
| --- | --- |
| `search_film_stocks` | Filter 68 stocks by text, ISO, type, grain, latitude, format, use case or price tier. |
| `get_film_stock` | One stock by id or name (`kodak-portra-400` / "Portra 400"). |
| `recommend_film` | Ranked picks for a scene (portrait, landscape, street, night, travel, studio, beginner). |
| `search_cameras` | Filter 60 bodies by text, type, mount, format or price tier. |
| `get_camera` | One camera by id or name (`nikon-fm2`). |
| `compare_films` | Two stocks side by side. |
| `audit_url` | Instant technical SEO audit of one public URL. 1 USDC. |

## Install

```bash
npx -y github:Feirobot/openfilm-mcp
```

Or clone it and run `node server.mjs`.

### Claude Desktop / Cursor / any MCP client

```json
{
  "mcpServers": {
    "openfilm": {
      "command": "npx",
      "args": ["-y", "github:Feirobot/openfilm-mcp"]
    }
  }
}
```

## Remote server

The same tools are hosted at **`https://openfilm.cc/mcp`** (Streamable HTTP, no auth, no install):

```bash
curl -s https://openfilm.cc/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## Official MCP Registry

The remote server is published in the official MCP Registry as
**`cc.openfilm/film-photography`** — search for it at
<https://registry.modelcontextprotocol.io/v0.1/servers?search=openfilm> or find it
through any client that reads the registry. The published metadata lives in
[`server.json`](./server.json).

It was published with the registry's **HTTP domain authentication** (an Ed25519 key),
which is why the name is under the `cc.openfilm` namespace rather than `io.github.*`.
The public half of the key is served at
<https://openfilm.cc/.well-known/mcp-registry-auth>.

## The data

`data.js` is a snapshot of the published datasets
([`film-stock-database.json`](https://openfilm.cc/film-stock-database.json),
[`camera-database.json`](https://openfilm.cc/camera-database.json)), version **1.0.1**.
The citable mirror with a Frictionless descriptor is
[Feirobot/film-photography-datasets](https://github.com/Feirobot/film-photography-datasets).
Schemas, provenance and citation notes: <https://openfilm.cc/en/open-data/>.

## Licence

The **code** in this repository is MIT. The **data** in `data.js` is
[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) — reuse it freely, including
commercially, with attribution to [openfilm.cc](https://openfilm.cc/).