FTIR.fun MCP Server

MCP wrapper for the hosted FTIR.fun spectral-library API.

This repository is intentionally small and public. It does not contain the private FTIR.fun web application, spectral-library data, API keys, user data, or institutional AI-only report-review logic.

What It Does

• Exposes one task-level MCP tool: analyze_ftir_spectrum

• Accepts FTIR peak lists, natural-language peak descriptions, or base64-encoded FTIR spectrum files

• Calls the hosted FTIR.fun API at https://ftir.fun/ftir/analyze_spectrum

• Returns ranked spectral-library candidates and evidence-oriented response fields from FTIR.fun

Configuration

Set one API key in the runtime environment:

export FTIRFUN_API_KEY="your-ftirfun-api-key"

Optional settings:

export FTIRFUN_API_BASE_URL="https://ftir.fun"
export FTIRFUN_API_TIMEOUT_SECONDS="120"

Run Locally

python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python ftirfun_mcp_server.py

Run Streamable HTTP

FTIRFUN_API_KEY="your-ftirfun-api-key" \
python ftirfun_mcp_server.py --transport streamable-http --host 127.0.0.1 --port 8001

Docker

docker build -t ftirfun-mcp .
docker run --rm -p 8001:8001 -e FTIRFUN_API_KEY="your-ftirfun-api-key" ftirfun-mcp

For registry introspection, the server can start without an API key. Tool calls that require the hosted API return a structured api_key_required error until FTIRFUN_API_KEY is configured.

Tool Boundary

Use analyze_ftir_spectrum for FTIR spectral-library screening only.

Do not use this MCP server for:

• non-FTIR spectroscopy

• general chemistry Q&A

• institutional AI-only review of existing third-party reports

• accredited laboratory certification

Hosted MCP

FTIR.fun also provides a hosted MCP endpoint:

https://ftir.fun/mcp

The hosted endpoint is the canonical production service. This public repository is the small open-source MCP wrapper used for public MCP registries and self-hosted client installs.