Traktamente MCP Server

Traktamente MCP服务器

一个MCP服务器，可从Skatteverket的官方API访问瑞典traktamente（每日）费率。

特性

• 🔍 按国家、年份或国家代码查询每日津贴率
• 🌍 搜索所有可用的国家
• 📊 访问Skatteverket的官方数据
• ⚡ 使用Bun实现快速轻量级
• 🔒 使用Zod模式验证的类型安全

安装

pnpm install traktamente-mcp

或者与Bun：

bun add traktamente-mcp

用法

使用克劳德桌面

将此配置添加到您的Claude Desktop配置文件中：

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

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

重新启动Claude Desktop，您将可以访问三个新工具：

• 获取训练 -使用过滤器查询每日津贴率（国家、年份、国家代码）
• 获取所有国家 -列出所有可用的国家
• 搜索_培训课程 -使用正则表达式模式搜索国家

使用流式HTTP（远程服务器）

服务器可作为托管服务在 https://traktamente.app/mcp，您无需在本地安装任何东西即可连接到。

克劳德代码

将服务器添加到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"
    }
  }
}

独立使用

# Start the server
bun start

# Development mode with hot reload
bun dev

# Test with MCP Inspector (interactive web UI)
bun run inspector

使用Docker

服务器可以在Docker容器中运行，这对于隔离环境或部署非常有用：

# Build the Docker image
docker build -t traktamente-mcp .

# Run with stdio transport (interactive)
docker run -i traktamente-mcp

# Or use Docker Compose
docker-compose up

Docker与克劳德桌面

要在Claude Desktop中使用Docker容器，请按如下方式配置：

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

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

备注：您需要先使用以下命令构建Docker镜像 docker build -t traktamente-mcp . 在项目目录中。

可用工具

get_traktamente

使用可选筛选器查询交易费率：

• land （字符串，可选）：国家名称或正则表达式模式
• år （字符串，可选）：年份
• landskod （字符串，可选）：国家代码（例如“US”、“GB”）
• limit （数字，可选）：最大结果数（默认值：100）
• offset （数字，可选）：分页偏移量（默认值：0）

get_all_countries

列出所有提供每日津贴数据的国家。无需参数。

search_traktamente

使用正则表达式模式搜索国家：

• search （字符串，必填）：搜索词或正则表达式模式
• limit （数字，可选）：最大结果数（默认值：50）

发展

先决条件

• 包子 运行时（v1.0.0或更高版本）

设置

# Clone the repository
git clone https://github.com/johnie/traktamente-mcp.git
cd traktamente-mcp

# Install dependencies
bun install

# Start development server
bun dev

MCP检验员测试

MCP检查器提供了一个用于测试服务器的交互式web UI：

bun run inspector

这将打开一个浏览器，您可以在其中测试所有可用工具并查看实时响应。

数据源

该服务器从Skatteverket的官方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© 约翰尼·赫勒姆

支持

• 问题:
• 讨论:

致谢

• 数据由 溜冰鞋
• 内置 模型上下文协议SDK
• 由...驱动 包子