Fizzy MCP 服务器使用指南

项目简介

Fizzy MCP Server 是一个基于 Model Context Protocol (MCP) 的中间件，让AI助手（如Claude、Cursor、GitHub Copilot）能够通过自然语言与Fizzy项目管理平台进行交互。

主要功能

• 完整API覆盖: 47个工具涵盖身份认证、看板、卡片、评论、标签、用户和通知等所有功能
• 多传输协议: 支持Stdio（IDE集成）、HTTP（生产部署）和SSE（向后兼容）
• 多用户支持: HTTP和SSE传输支持多个用户同时连接，每个会话独立隔离
• 智能重试机制: 自动处理瞬时故障，支持指数退避重试
• ETag缓存: 自动HTTP缓存减少带宽使用，提高响应速度
• 企业级部署: 支持Node.js本地部署和Cloudflare Workers边缘部署

安装步骤

方法1: 使用npx（推荐快速体验）

FIZZY_ACCESS_TOKEN="你的Fizzy访问令牌" npx fizzy-mcp

方法2: 全局安装

npm install -g fizzy-mcp

方法3: 从源码安装

git clone https://github.com/Fabric-Pro/fizzy-mcp.git
cd fizzy-mcp
npm install
npm run build
npm link

服务器配置

获取Fizzy访问令牌

1. 登录 Fizzy账户
2. 进入个人资料 → API → 个人访问令牌
3. 生成令牌并选择权限（推荐读写权限）

IDE配置示例

Cursor IDE配置:

{
  "mcpServers": {
    "fizzy": {
      "command": "npx",
      "args": ["-y", "fizzy-mcp"],
  "env": {
    "FIZZY_ACCESS_TOKEN": "你的令牌"
  }
}

VS Code配置: 在'.vscode/mcp.json'中添加：

{
  "mcpServers": {
    "fizzy": {
      "command": "npx",
      "args": ["-y", "fizzy-mcp"],
  "env": {
    "FIZZY_ACCESS_TOKEN": "你的令牌"
  }
}

Claude Desktop配置: 在配置文件中添加：

{
  "mcpServers": {
    "fizzy": {
      "command": "npx",
      "args": ["-y", "fizzy-mcp"],
  "env": {
    "FIZZY_ACCESS_TOKEN": "你的令牌"
  }
}

基本使用方法

配置完成后，即可向AI助手提问，例如：

• "显示我所有的Fizzy看板"
• "在工程看板上创建一张名为'修复登录bug'的卡片"
• "将'设计评审'卡片移动到'完成'列"
• "查看我的未读通知"

服务器会自动处理所有Fizzy API调用，让你能够专注于使用自然语言管理项目。