ahnl/torium

芬兰 Tori.fi 市场的非官方Python客户端。 🇫🇮 

浏览房源，管理自己的房源，并与买家聊天。无论是在终端、你的Python代码还是Claude。

安装 • CLI • MCP工具 • 图书馆

---

安装

选择您偏好的安装方式：

• 托管远程MCP服务器。最简单，只需将 claude.ai 或 ChatGPT 连接到 https://torium.fi/mcp。
• 本地安装（MCP 和 CLI）。在您自己的机器上运行 MCP 服务器和 CLI。
• 自托管远程MCP服务器。自己托管远程MCP服务器。

托管远程MCP服务器

使用Torium最简单的方法。我们将MCP服务器托管在https://torium.fi/mcp。只需在 claude.ai 添加作为连接器，并用你的 Tori.fi 账号登录即可。

请参见torium.fi，了解设置说明和视频演示。

本地安装（MCP 和 CLI）

1.克隆与安装：

这会在你的PATH上全局放置torium-mcp（和torium）。

2.认证一次（一次）:

打开浏览器进行 OAuth 登录。在 macOS 和 Linux 上，重定向会自动被捕获（Linux 通过 xdg-mime 注册一个临时的 .desktop URL 处理程序）。

An unofficial Python client for the Finnish Tori.fi marketplace. 🇫🇮 

Browse listings, manage your own listings, and chat with buyers. From the terminal, your Python code, or Claude.

Installation • CLI • MCP Tools • Library

---

Installation

Choose your preferred installation method:

• Hosted remote MCP server. Easiest, just connect claude.ai or ChatGPT to https://torium.fi/mcp.
• Local install (MCP and CLI). Run the MCP server and CLI on your own machine.
• Self-hosted remote MCP server. Host the remote MCP server yourself.

Hosted remote MCP server

The simplest way to use Torium. We host the MCP server at https://torium.fi/mcp. Just add it as a connector in claude.ai and log in with your Tori.fi account.

See torium.fi for setup instructions and a video walkthrough.

Local install (MCP and CLI)

1. Clone and install:

git clone https://github.com/ahnl/torium
uv tool install ./torium

This places torium-mcp (and torium) on your PATH globally.

2. Authenticate (once):

torium auth setup

Opens a browser for OAuth login. On macOS and Linux the redirect is captured automatically (Linux registers a temporary .desktop URL handler via xdg-mime).

On Windows, after login the browser will show an infinite loading spinner or a “can’t open” error. Open the browser’s developer tools (F12) → Console, find the failed redirect URL starting with fi.tori.www..., right-click it to copy the link address, and paste it into the terminal. Do this quickly. The code in the URL expires in 30-60 seconds.

Credentials will be saved to ~/.config/torium/credentials.json. Alternatively, set TORI_REFRESH_TOKEN in your environment. The MCP server will use it directly, no credentials file needed.

3. MCP: Add to Claude Desktop:

Go to Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "torium": {
      "command": "torium-mcp"
    }
  }
}

Restart Claude Desktop. The torium tools are now available.

Updating:

cd torium && git pull && uv tool install --reinstall .

Self-hosted remote MCP server