Tuskr MCP Server

tuskr mcp服务器

为实现模型上下文协议（MCP）服务器 Tuskr REST API

基于FastMCP Python SDK构建。\ 支持访问令牌身份验证。

安装

环境变量/ .env 文件

设置环境变量或配置 .env 文件使用 .env.example 模板。

支持以下环境变量：

TUSKR_ACCOUNT_ID=
TUSKR_ACCESS_TOKEN=

（这位医生https://tuskr.app/kb/latest/api)

并且可选

MCP_TRANSPORT=
MCP_HOST=
MCP_PORT=

命令行参数

MCP服务器支持以下命令行参数：

• --transport：MCP服务器的传输类型。选项： http （默认）或 stdio
• --host：HTTP传输的主机地址（默认值： 0.0.0.0)
• --port：HTTP传输的端口号（默认值： 8000)

备注：The --host 和 --port 参数仅在使用时适用 http 运输。

默认值

• 运输: http （可以用以下命令覆盖 MCP_TRANSPORT 环境变量）
• 主机: 0.0.0.0 （可以用以下命令覆盖 MCP_HOST 环境变量）
• 端口: 8000 （可以用以下命令覆盖 MCP_PORT 环境变量）

从客户端连接

HTTP传输（默认）

使用以下模板通过HTTP连接服务器：

{
  "mcpServers": {
    "tuskr": {
      "transport": "http",
      "url": "http:///mcp/",
      "headers": {
        "Authorization": "Bearer ",
        "Account-ID": ""
      }
    }
  }
}

这 Authorization 是强制性的。

这 Account-ID 不需要，可以在服务器端使用 TUSKR_ACCOUNT_ID env变量。如果您有一个用于组织的MCP服务器，这很方便。

stdio交通（促进当地发展）

用于本地开发和与以下工具的集成 uvx，使用 stdio 运输：

{
  "mcpServers": {
    "tuskr": {
      "transport": "stdio",
      "command": "uvx",
      "args": ["tuskr-mcp-server", "--transport", "stdio"]
    }
  }
}

或使用 uv 源代码：

{
  "mcpServers": {
    "tuskr": {
      "transport": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/tuskr-mcp-server",
        "run",
        "src/main.py",
        "--transport",
        "stdio"
      ]
    }
  }
}

发展

设置

1. 克隆仓库
2. 安装开发依赖项：

uv sync --dev

1. 创建 .env 从 .env.example

正在运行MCP服务

HTTP传输（默认）

uv run --env-file .env src/main.py

stdio交通（促进当地发展）

uv run --env-file .env src/main.py --transport stdio

自定义主机/端口

uv run --env-file .env src/main.py --host 127.0.0.1 --port 9000

运行测试

该项目使用pytest进行测试。以下命令将运行所有测试

uv run pytest -vsx

运行过梁

该项目使用 ruff 作为过梁的工具。

以下命令允许运行linter

uv run ruff check

此命令允许修复格式

uv run ruff format

码头化

以下命令允许构建docker镜像

docker build -t tuskr-mcp .

然后，您可以使用

docker run -it tuskr-mcp