mcpField
F
Fizzy MCP

Fizzy MCP

本地服务
github.com/davegomez生产力337 周前更新
代码仓库

关于 Fizzy MCP

Fizzy MCP 将 MCP 客户端连接到 Fizzy 任务管理，提供看板、卡片、评论和清单操作。它支持按条件搜索卡片，并可创建、更新和跟踪任务。

主要功能

  1. 01列出账户和看板
  2. 02按条件搜索卡片
  3. 03获取卡片详情
  4. 04创建和更新卡片
  5. 05管理卡片评论
  6. 06管理清单步骤

适用场景

  1. 01按看板、负责人或状态查找卡片
  2. 02创建或更新任务卡片
  3. 03查看和修改卡片评论
  4. 04跟踪清单完成情况

MCP 相关

它通过七种 MCP 工具提供 Fizzy 账户、看板、卡片、评论和清单操作。

#task-management#kanban#productivity#fizzy

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "fizzy": {
      "command": "npx",
      "args": [
        "-y",
        "@silky/fizzy-mcp"
      ],
      "env": {
        "FIZZY_TOKEN": "<FIZZY_TOKEN>",
        "FIZZY_BASE_URL": "<FIZZY_BASE_URL>",
        "FIZZY_ACCOUNT": "<FIZZY_ACCOUNT>"
      }
    }
  }
}
启动命令npx -y @silky/fizzy-mcp
需要配置的环境变量
FIZZY_TOKEN密钥Fizzy API authentication token
FIZZY_BASE_URLFizzy API base URL (defaults to production)
FIZZY_ACCOUNTDefault Fizzy account slug

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@silky/fizzy-mcp1.0.0

工具

7

收录的工具列表 · 更新于 3 周前

参数类型必填说明
actionenum是操作：get（获取）| set（设置）| list（列出）。使用 'get' 查看当前值，使用 'set' 进行更改，使用 'list' 查看可用选项。get | set | list
account_slugstring否账户 slug（set 操作时必填）。

详细介绍

fizzy-mcp

用于 Fizzy 任务管理的 MCP 服务。提供 7 个用于管理看板、卡片、评论和检查清单的工具。

前置条件

获取 Fizzy 访问令牌：

  1. 登录 Fizzy
  2. 前往「Settings」>「API Access」
  3. 生成新令牌

安装方法

Claude Desktop

将以下内容添加到配置文件：

  • macOS： ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Windows： %APPDATA%\Claude\claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      }
    }
  }
}

仅限 Windows： 在 env 块中添加 "APPDATA": "C:\\Users\\YourUsername\\AppData\\Roaming"。

完全重启 Claude Desktop，然后进行验证：「列出我的 Fizzy 看板。」

Claude Code

使用命令行：

claude mcp add --transport stdio Fizzy --env FIZZY_TOKEN=your-token-here -- npx -y @silky/fizzy-mcp

或者添加到 ~/.claude.json：

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      }
    }
  }
}

重启 Claude Code，然后进行验证：「列出我的 Fizzy 看板。」

Cursor

添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）：

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      }
    }
  }
}

完全重启 Cursor，然后在 Agent 模式下进行验证（Ctrl+I）。

VS Code

添加到工作区中的 .vscode/mcp.json：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "fizzy-token",
      "description": "Fizzy API Token",
      "password": true
    }
  ],
  "servers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "${input:fizzy-token}"
      }
    }
  }
}

或者通过命令面板 →「MCP: Open User Configuration」使用用户设置。

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "${env:FIZZY_TOKEN}"
      }
    }
  }
}

在 shell 环境中设置 FIZZY_TOKEN，或直接写入该值。重启 Windsurf。

Cline

添加到 Cline MCP 设置文件：

  • macOS： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Windows： %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Linux： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}
Continue

添加到 .continue/config.yaml：

mcpServers:
  - name: Fizzy
    command: npx
    args:
      - "-y"
      - "@silky/fizzy-mcp"
    env:
      FIZZY_TOKEN: ${{ secrets.FIZZY_TOKEN }}
从源代码安装

需要 pnpm。

git clone https://github.com/davegomez/fizzy-mcp.git
cd fizzy-mcp
pnpm install
pnpm build

在上述任意配置中，将 npx -y @silky/fizzy-mcp 替换为 node /absolute/path/to/fizzy-mcp/dist/index.js。

配置参考

变量必需默认值说明
FIZZY_TOKEN是—Fizzy 设置中的 API 令牌
FIZZY_ACCOUNT否—默认账户 slug（例如：897362094）
FIZZY_BASE_URL否https://app.fizzy.doAPI 基础 URL
账户解析

工具按以下顺序解析 account_slug：

  1. 工具调用中显式指定的 account_slug 参数
  2. 会话默认值（通过 fizzy_account 工具设置，使用 action: "set"）
  3. FIZZY_ACCOUNT 环境变量
  4. 自动检测（如果用户只有一个账户）

工具参考

fizzy_account

获取、设置或列出后续工具调用使用的账户。

参数类型必需说明
action"get" | "set" | "list"是要执行的操作
account_slugstring设置时Fizzy URL 中的账户 slug

返回：

  • get：{ "action": "get", "account_slug": "897362094" | null }
  • set：{ "action": "set", "account_slug": "897362094" }
  • list：{ "action": "list", "accounts": [{ "slug": "...", "name": "...", "id": "..." }] }
fizzy_boards

列出账户中的看板及其列摘要。

ParameterTypeRequiredDefaultDescription
account_slugstringNoSession default账户 slug
limitnumberNo25每页条目数（1-100）
cursorstringNo—分页游标

返回： { "items": Board[], "pagination": { "returned": number, "has_more": boolean, "next_cursor"?: string } }

fizzy_search

按筛选条件搜索卡片。

ParameterTypeRequiredDescription
account_slugstringNo账户 slug
board_idstringNo按看板筛选
tag_idsstring[]No按所有标签筛选
assignee_idsstring[]No按任意负责人筛选
creator_idsstring[]No按卡片创建者筛选
closer_idsstring[]No按关闭者筛选
card_idsstring[]No按指定卡片 ID 筛选
indexed_by"closed" | "not_now" | "all" | "stalled" | "postponing_soon" | "golden"No按索引筛选
assignment_status"unassigned"No按分配状态筛选
sorted_by"newest" | "oldest" | "recently_active"No排序方式
termsstring[]No全文搜索词
creation日期范围*No按创建日期筛选
closure日期范围*No按关闭日期筛选
limitnumberNo每页条目数（1-100，默认 25）
cursorstringNo分页游标

*日期范围值：today、yesterday、thisweek、thismonth、last7、last14、last30。

返回： { "items": Card[], "pagination": {...} }

fizzy_get_card

按编号或 ID 获取卡片的完整详情。

ParameterTypeRequiredDescription
account_slugstringNo账户标识
card_numbernumberNo*URL 中的卡片编号（例如，#42 中的 42）
card_idstringNo*API 响应中的卡片 UUID

*请提供 card_number 或 card_id。如果你能从 UI 获取易读的 # 编号，优先使用 card_number。

**返回：**包含 id、number、title、description（Markdown）、status、board_id、column_id、tags、assignees、steps_count、completed_steps_count、comments_count、url 和时间戳的卡片对象。

fizzy_task

创建或更新卡片。

**模式：**省略 card_number 表示创建；提供该参数表示更新。

ParameterTypeRequiredDescription
account_slugstringNo账户标识
card_numbernumberNo要更新的卡片（创建时省略）
board_idstringCreate mode新卡片所属看板
titlestringCreate mode卡片标题
descriptionstringNoMarkdown 内容
status"open" | "closed" | "not_now"No更改卡片状态
column_idstringNo将卡片分配到指定列
position"top" | "bottom"No列中的位置（默认值："bottom"）
add_tagsstring[]No要添加的标签标题
remove_tagsstring[]No要移除的标签标题
stepsstring[]No清单条目（仅创建模式）

返回：{ "mode": "create" | "update", "card": {...}, "operations": {...}, "failures": [...] }

fizzy_comment

创建、列出、更新或删除卡片上的评论。

ParameterTypeRequiredDescription
actionstringNo"create"（默认）、"list"、"update"、"delete"
account_slugstringNo账户标识
card_numbernumberYes卡片编号
comment_idstringNo评论 ID。更新或删除时必填
bodystringNoMarkdown 格式的评论（1-10000 个字符）。创建或更新时必填

**返回：**包含 id、body（Markdown）、creator、时间戳和 url 的评论对象。列表操作返回 { comments, pagination }。删除操作返回 { comment_id, deleted }。

fizzy_step

在卡片上创建、完成、更新、取消完成或删除一个步骤。

ParameterTypeRequiredDescription
account_slugstringNo账户标识
card_numbernumberYes包含该步骤的卡片
stepstring | numberNo内容子字符串或从 1 开始的索引。省略则创建。
contentstringNo创建或更新时使用的步骤文本
completedbooleanNo设置完成状态
deletebooleanNo删除该步骤

模式检测：

  • 未提供 step → 创建（需要 content）
  • 已提供 step，且未提供其他参数 → 完成
  • step + content → 更新
  • step + completed: false → 取消完成
  • step + delete: true → 删除

返回： { "id": "...", "content": "...", "completed": true }

分页参考

列表操作返回：

{
  "items": [...],
  "pagination": {
    "returned": 25,
    "has_more": true,
    "next_cursor": "opaque-cursor-string"
  }
}
FieldTypeDescription
returnednumber此响应中的项目数
has_moreboolean是否还有更多项目
next_cursorstring作为下一页的 cursor 传入

错误参考

ErrorCause
"No account specified. Set FIZZY_ACCOUNT env var, use fizzy_account tool, or pass account_slug."通过任何方式都无法解析账户
"Account "..." not found"传入 fizzy_account 的标识无效
"Card #N not found"卡片编号不存在
"Board not found"board_id 无效

许可证

AGPL-3.0-or-later

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。