Traktamente MCP

🚀 Traktamente MCP 服務器

這是一個 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 後，你將可以使用三個新工具：

• get_traktamente - 使用過濾器（國家、年份、國家代碼）查詢每日津貼費率。
• get_all_countries - 列出所有可用國家。
• search_traktamente - 使用正則表達式模式搜索國家。

通過可流式傳輸的 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 Inspector 進行測試（交互式 Web 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

可使用可選過濾器查詢每日津貼費率：

• 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 Inspector 進行測試

MCP Inspector 提供了一個交互式 Web 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 提供支持。