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 提供支持。