# feeling-search-mcp

> MCP server for [feeling-search](https://xiximm.cloud) — turn one colloquial sentence into
> **762 feeling words** and **598 visual styles**, each style carrying its name, a one-line
> definition and the words that triggered it.

A commercial-grade art reference chart, art-style encyclopedia and art-style AI prompt
dictionary, exposed over the Model Context Protocol.

```
"下雨天一个人走在便利店门口，冷白灯光"
   → 感受词：星光 / 窗光 / 冷光 …
   → 视觉风格：垂直式哥特 / 星图 / 托莱多画派 …
```

## Install

```jsonc
{
  "mcpServers": {
    "feeling-search": {
      "command": "npx",
      "args": ["-y", "feeling-search-mcp"]
    }
  }
}
```

That is the whole setup — no API key, no account, no local data download.

## Tools

| Tool | What it does | Cost |
|---|---|---|
| `word_analyze` | One sentence → feeling words + matching visual styles | free (local tier) |
| `word_lookup` | Look up a single feeling word: definition, near-synonyms, landing styles | free |
| `word_list` | Browse / search the 762-word lexicon | free |
| `style_get` | One style in full: definition, parent style, member words, reference images | free |
| `word_status` | Lexicon version, counts, coverage — use it to check the data is fresh | free |

Every tool is read-only and costs nothing. The paid `/v2/analyze` cloud path is **off by
default** on the public endpoint and only runs when a caller explicitly opts in.

## Why a bridge, not a bundled server

This package is a thin stdio ↔ HTTP bridge to `https://xiximm.cloud/mcp`. The lexicon and
matching logic live in exactly one place, so the package can never drift from the data:

- **Nothing to download** — the package is a few KB; the 26 MB corpus stays server-side
- **Always current** — a lexicon update is live the moment the site deploys, no `npm update`
- **Tiny audit surface** — no `eval`/`exec`/`subprocess`, no filesystem writes, one outbound host

If you need a fully offline server, run the project's own `mcp/stdio.mjs` from a checkout
with the data directory present.

## Configuration

| Env / flag | Default | Meaning |
|---|---|---|
| `FS_MCP_URL` / `--endpoint` | `https://xiximm.cloud/mcp` | Endpoint to bridge to |
| `FS_MCP_TOKEN` | unset | Sent as `Authorization: Bearer <token>` when the endpoint is gated |
| `--timeout` | `30000` | Per-request timeout in ms |

`stdout` carries protocol messages only; all diagnostics go to `stderr`.

## Related

- Agent skill: [`xixi048/feeling-search-skill`](https://github.com/xixi048/feeling-search-skill) — same vocabulary, works offline from a local cache
- Site + API: [xiximm.cloud](https://xiximm.cloud/docs/api.html)

## License

MIT