ahnl/torium

フィンランドの Tori.fi 市場向けの非公式な Python クライアント。 🇫🇮 

リストをブラウズし、あなた自身のリストを管理し、バイヤーとチャット. ターミナル、Pythonコード、またはClaudeから。

インストール • クリップ&ブル; MCPの特長 ツール • ライブラリー

お問い合わせ

インストール

ご希望のインストール方法を選択してください:

• ホストされたリモートMCPサーバー。 一番簡単で、claude.ai または ChatGPT を [https://torium.fi/mcp] に接続します。
• ローカルインストール(MCPとCLI)。 MCP サーバーとCLI をマシン上で実行します。
• セルフホストリモートMCPサーバー。 リモート MCP サーバーを自分でホストします。

ホストリモート MCP サーバー

トリウムを使用する最も簡単な方法。 MCP サーバーを [https://torium.fi/mcp でホストします。 claude.aiでコネクターとして追加し、Tori.fiアカウントでログインしてください。

セットアップ手順とビデオウォークスルーについては、torium.fiを参照してください。

##ローカルインストール(MCPとCLI)

1. クローンとインストール:

PATH の torium-mcp (および torium) をグローバルに配置します。

2. 認証(オンス):

OAuthログイン用のブラウザを開きます。 macOS と Linux では、リダイレクトが自動的にキャプチャされます (Linux は、一時 [[.desktop]]] URL ハンドラを [xdg-mime]]]).

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