Fizzy

io.github.davegomez由 GitHub 账号 davegomez 发布v1.0.0更新于 Oct 27, 2026

MCP server for Fizzy task management

已验证STDIO仅桌面效率与工作流开发者工具

概览

AI 生成的概览

本地 MCP 服务器，把助手接入 Fizzy 任务管理，可浏览看板、搜索卡片，并管理卡片、评论和清单步骤。

可以做什么
  • 列出账户中的看板及列摘要，支持分页
  • 按看板、标签、负责人、创建者、关闭者、索引、日期和关键词搜索卡片
  • 按卡片编号或 ID 读取卡片完整详情
  • 创建或更新卡片，包括状态、列、位置、标签和清单项
  • 创建、列出、更新和删除卡片评论
  • 创建、完成、更新、取消完成或删除清单步骤，并获取、设置或列出当前账户
适用场景
当你的任务放在 Fizzy 中，希望助手直接查看看板和卡片、按标签或负责人或日期查找工作，并创建或更新卡片、评论和清单项而无需切换应用时适用。
运行要求
通过 npx 从 npm 包 @silky/fizzy-mcp 在本地运行，需要 Node.js。需要在 FIZZY_TOKEN 中提供 Fizzy API 令牌，可在 Settings > API Access 生成。可选 FIZZY_ACCOUNT 设置默认账户 slug，FIZZY_BASE_URL 覆盖 API 基础地址。需要访问 Fizzy 的网络连接。
安装前请注意
Fizzy API 令牌属于凭据，不要写入共享配置文件，建议使用输入提示或环境变量引用。该服务器可创建、更新和删除卡片、评论与步骤，助手操作会改动真实任务数据。任务内容会发送到所配置基础地址的 Fizzy API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Fizzy，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

fizzy-mcp

MCP server for Fizzy task management. Exposes 7 tools for managing boards, cards, comments, and checklists.

Prerequisites

Get your Fizzy access token:

  1. Log in to Fizzy
  2. Go to Settings > API Access
  3. Generate a new token

How to Install

Claude Desktop

Add to your config file:

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

Windows only: Add "APPDATA": "C:\\Users\\YourUsername\\AppData\\Roaming" to the env block.

Restart Claude Desktop completely, then verify: "List my Fizzy boards."

Claude Code

Use the CLI:

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

Or add to ~/.claude.json:

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

Restart Claude Code, then verify: "List my Fizzy boards."

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

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

Restart Cursor completely, then verify in Agent mode (Ctrl+I).

VS Code

Add to .vscode/mcp.json in your workspace:

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}"      }    }  }}

Or use user settings via Command Palette → "MCP: Open User Configuration".

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

Set FIZZY_TOKEN in your shell environment, or hardcode the value. Restart Windsurf.

Cline

Add to the Cline MCP settings file:

  • 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
json
{  "mcpServers": {    "Fizzy": {      "command": "npx",      "args": ["-y", "@silky/fizzy-mcp"],      "env": {        "FIZZY_TOKEN": "your-token-here"      },      "disabled": false,      "alwaysAllow": []    }  }}
Continue

Add to .continue/config.yaml:

yaml
mcpServers:  - name: Fizzy    command: npx    args:      - "-y"      - "@silky/fizzy-mcp"    env:      FIZZY_TOKEN: ${{ secrets.FIZZY_TOKEN }}
From Source

Requires pnpm.

bash
git clone https://github.com/davegomez/fizzy-mcp.gitcd fizzy-mcppnpm installpnpm build

Replace npx -y @silky/fizzy-mcp with node /absolute/path/to/fizzy-mcp/dist/index.js in any config above.

Configuration Reference

VariableRequiredDefaultDescription
FIZZY_TOKENYes—API token from Fizzy settings
FIZZY_ACCOUNTNo—Default account slug (e.g., 897362094)
FIZZY_BASE_URLNohttps://app.fizzy.doAPI base URL

Account Resolution

Tools resolve account_slug in this order:

  1. Explicit account_slug parameter on the tool call
  2. Session default (set via fizzy_account tool with action: "set")
  3. FIZZY_ACCOUNT environment variable
  4. Auto-detect (if user has exactly one account)

Tools Reference

fizzy_account

Gets, sets, or lists accounts for subsequent tool calls.

ParameterTypeRequiredDescription
action"get" | "set" | "list"YesAction to perform
account_slugstringFor setAccount slug from Fizzy URL

Returns:

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

fizzy_boards

Lists boards in the account with column summaries.

ParameterTypeRequiredDefaultDescription
account_slugstringNoSession defaultAccount slug
limitnumberNo25Items per page (1-100)
cursorstringNo—Pagination cursor

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

fizzy_search

Searches for cards with filters.

ParameterTypeRequiredDescription
account_slugstringNoAccount slug
board_idstringNoFilter by board
tag_idsstring[]NoFilter by ALL tags
assignee_idsstring[]NoFilter by ANY assignees
creator_idsstring[]NoFilter by card creator
closer_idsstring[]NoFilter by who closed
card_idsstring[]NoFilter to specific card IDs
indexed_by"closed" | "not_now" | "all" | "stalled" | "postponing_soon" | "golden"NoFilter by index
assignment_status"unassigned"NoFilter by assignment status
sorted_by"newest" | "oldest" | "recently_active"NoSort order
termsstring[]NoFree-text search terms
creationdate range*NoFilter by creation date
closuredate range*NoFilter by closure date
limitnumberNoItems per page (1-100, default 25)
cursorstringNoPagination cursor

*Date range values: today, yesterday, thisweek, thismonth, last7, last14, last30.

Returns: { "items": Card[], "pagination": {...} }

fizzy_get_card

Gets full details of a card by number or ID.

ParameterTypeRequiredDescription
account_slugstringNoAccount slug
card_numbernumberNo*Card number from URL (e.g., 42 from #42)
card_idstringNo*Card UUID from API responses

*Provide card_number OR card_id. Prefer card_number when you have the human-readable # from the UI.

Returns: Card object with id, number, title, description (markdown), status, board_id, column_id, tags, assignees, steps_count, completed_steps_count, comments_count, url, timestamps.

fizzy_task

Creates or updates a card.

Mode: Omit card_number to create; include it to update.

ParameterTypeRequiredDescription
account_slugstringNoAccount slug
card_numbernumberNoCard to update (omit to create)
board_idstringCreate modeBoard for new card
titlestringCreate modeCard title
descriptionstringNoMarkdown content
status"open" | "closed" | "not_now"NoChange card status
column_idstringNoTriage to column
position"top" | "bottom"NoPosition in column (default: "bottom")
add_tagsstring[]NoTag titles to add
remove_tagsstring[]NoTag titles to remove
stepsstring[]NoChecklist items (create mode only)

Returns: { "mode": "create" | "update", "card": {...}, "operations": {...}, "failures": [...] }

fizzy_comment

Create, list, update, or delete a comment on a card.

ParameterTypeRequiredDescription
actionstringNo"create" (default), "list", "update", "delete"
account_slugstringNoAccount slug
card_numbernumberYesCard number
comment_idstringNoComment ID. Required for update/delete
bodystringNoComment in markdown (1-10000 chars). Required for create/update

Returns: Comment object with id, body (markdown), creator, timestamps, url. List returns { comments, pagination }. Delete returns { comment_id, deleted }.

fizzy_step

Create, complete, update, uncomplete, or delete a step on a card.

ParameterTypeRequiredDescription
account_slugstringNoAccount slug
card_numbernumberYesCard containing the step
stepstring | numberNoContent substring OR 1-based index. Omit to create.
contentstringNoStep text for create or update
completedbooleanNoSet completion state
deletebooleanNoDelete the step

Mode detection:

  • step absent → CREATE (requires content)
  • step present, no other params → COMPLETE
  • step + content → UPDATE
  • step + completed: false → UNCOMPLETE
  • step + delete: true → DELETE

Returns: { "id": "...", "content": "...", "completed": true }

Pagination Reference

List operations return:

json
{  "items": [...],  "pagination": {    "returned": 25,    "has_more": true,    "next_cursor": "opaque-cursor-string"  }}
FieldTypeDescription
returnednumberItems in this response
has_morebooleanMore items available
next_cursorstringPass as cursor for next page

Error Reference

ErrorCause
"No account specified. Set FIZZY_ACCOUNT env var, use fizzy_account tool, or pass account_slug."No account resolvable via any method
"Account "..." not found"Invalid slug passed to fizzy_account set
"Card #N not found"Card number does not exist
"Board not found"Invalid board_id

License

AGPL-3.0-or-later

来源：README.md，提交 c4dd809

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分