Traktamente MCP

🚀 Traktamente MCP Server

このMCPサーバーは、スウェーデンの税務庁（Skatteverket）の公式APIから日当てレート（traktamente）にアクセスできるようにします。

✨ 主な機能

• 🔍 国、年、または国コードで日当てレートを照会できます。
• 🌍 利用可能なすべての国を検索できます。
• 📊 税務庁の公式データにアクセスできます。
• ⚡ Bunを使用した高速で軽量な実装です。
• 🔒 Zodスキーマ検証による型安全な実装です。

📦 インストール

pnpm install traktamente-mcp

または、Bunを使用する場合は:

bun add traktamente-mcp

💻 使用例

Claude Desktopでの使用

Claude Desktopの設定ファイルに以下の設定を追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "traktamente": {
      "command": "npx",
      "args": ["traktamente-mcp"]
    }
  }
}

Claude Desktopを再起動すると、3つの新しいツールが利用可能になります。

• get_traktamente - フィルタ（国、年、国コード）で日当てレートを照会します。
• get_all_countries - 利用可能なすべての国をリストします。
• search_traktamente - 正規表現パターンを使用して国を検索します。

Streamable HTTP（リモートサーバー）での使用

サーバーはホスティングサービスとして https://traktamente.app/mcp で利用可能です。これを使用すると、ローカルに何もインストールすることなく接続できます。

Claude Codeでの使用

Claude Codeにサーバーを追加する最も簡単な方法は、CLIを使用することです。

claude mcp add --transport http traktamente https://traktamente.app/mcp

または、手動でClaude Codeの設定（~/.config/claude/config.json またはUI設定を介して）に追加することもできます。

{
  "mcpServers": {
    "traktamente": {
      "transport": "http",
      "url": "https://traktamente.app/mcp"
    }
  }
}

スタンドアローンでの使用

# サーバーを起動する
bun start

# ホットリロード付きの開発モード
bun dev

# MCPインスペクターでテスト（インタラクティブなウェブUI）
bun run inspector

Dockerでの使用

サーバーはDockerコンテナ内で実行できます。これは、分離された環境やデプロイに便利です。

# Dockerイメージをビルドする
docker build -t traktamente-mcp .

# stdioトランスポートで実行（インタラクティブ）
docker run -i traktamente-mcp

# またはDocker Composeを使用する
docker-compose up

DockerとClaude Desktopでの使用

Claude DesktopでDockerコンテナを使用するには、以下のように設定します。

macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "traktamente": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "traktamente-mcp"]
    }
  }
}

注意: プロジェクトディレクトリで docker build -t traktamente-mcp . を使用してDockerイメージを最初にビルドする必要があります。

利用可能なツール

get_traktamente

オプションのフィルタでtraktamenteレートを照会します。

• land (文字列、オプション): 国名または正規表現パターン
• år (文字列、オプション): 年
• landskod (文字列、オプション): 国コード（例: "US", "GB"）
• limit (数値、オプション): 最大結果数（デフォルト: 100）
• offset (数値、オプション): ページネーションオフセット（デフォルト: 0）

get_all_countries

利用可能な日当てデータがあるすべての国をリストします。パラメータは不要です。

search_traktamente

正規表現パターンを使用して国を検索します。

• search (文字列、必須): 検索用語または正規表現パターン
• limit (数値、オプション): 最大結果数（デフォルト: 50）

開発

前提条件

• Bun ランタイム（v1.0.0以上）

セットアップ

# リポジトリをクローンする
git clone https://github.com/johnie/traktamente-mcp.git
cd traktamente-mcp

# 依存関係をインストールする
bun install

# 開発サーバーを起動する
bun dev

MCPインスペクターでのテスト

MCPインスペクターは、サーバーをテストするためのインタラクティブなウェブUIを提供します。

bun run inspector

これにより、利用可能なすべてのツールをテストし、リアルタイムのレスポンスを確認できるブラウザが開きます。

データソース

このサーバーは、税務庁の公式APIからデータを取得します。

• API URL: https://skatteverket.entryscape.net/rowstore/dataset/70ccea31-b64c-4bf5-84c7-673f04f32505
• データ: 国際旅行の日当てレート
• 言語: スウェーデン語（国名とフィールド名）

コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

1. リポジトリをフォークする
2. 機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. 変更をコミットする (git commit -m 'feat: add some amazing feature')
4. ブランチにプッシュする (git push origin feature/amazing-feature)
5. プルリクエストを開く

開発ガイドライン

• すべてのコマンドにBunを使用します（Node.jsやnpmではなく）。
• 既存のコードスタイルに従います（Biomeによって強制されます）。
• 新しい機能にはテストを追加します。
• 必要に応じてドキュメントを更新します。

📄 ライセンス

MIT © Johnie Hjelm

サポート

• 問題報告: GitHub Issues
• ディスカッション: GitHub Discussions

謝辞

• データ提供: Skatteverket
• 構築に使用: Model Context Protocol SDK
• 動力源: Bun