Quire MCP

Quire MCP服务器

A. 模型上下文协议（MCP） 服务器 一刀 项目管理平台。

该服务器允许AI助手（如Claude）安全地与您的Quire项目、任务和数据进行交互。

快速开始

先决条件

• Node.js v22或更高版本
• Quire帐户
• Quire OAuth应用程序（请参阅 创建Quire OAuth应用程序)

步骤1：创建Quire OAuth应用程序

1. 首选 Quire应用程序管理
2. 点击 创建新应用
3. 集 重定向网址 致： http://localhost:3000/callback
4. 选择所需的权限范围
5. 复制 开发客户端ID 和 开发客户端密码

步骤2：配置MCP客户端

选择与您的MCP客户端匹配的设置：

克劳德桌面（推荐）

添加到您的 claude_desktop_config.json:

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quire": {
      "command": "npx",
      "args": ["-y", "quire-mcp"],
      "env": {
        "QUIRE_OAUTH_CLIENT_ID": "your-client-id",
        "QUIRE_OAUTH_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

克劳德代码（CLI）

添加到您的Claude Code MCP设置中(~/.claude/mcp.json 或项目级别）：

{
  "mcpServers": {
    "quire": {
      "command": "npx",
      "args": ["-y", "quire-mcp"],
      "env": {
        "QUIRE_OAUTH_CLIENT_ID": "your-client-id",
        "QUIRE_OAUTH_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

光标

在游标设置中，添加MCP服务器：

{
  "mcpServers": {
    "quire": {
      "command": "npx",
      "args": ["-y", "quire-mcp"],
      "env": {
        "QUIRE_OAUTH_CLIENT_ID": "your-client-id",
        "QUIRE_OAUTH_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

步骤3：首次授权

首次使用时，服务器将：

1. 将授权URL打印到控制台
2. 等待您在浏览器中打开该URL
3. 授予访问权限后，Quire重定向到localhost
4. 服务器捕获令牌并缓存它们

后续使用将根据需要自动刷新令牌。

运输方式

服务器支持两种传输模式： 标准 （默认）和 超文本传输协议.

STDIO模式（默认）

STDIO模式是最简单的设置。MCP客户端直接生成服务器进程，并通过stdin/stdout上的JSON-RPC进行通信。

它是如何工作的：

1. MCP客户端生成 npx quire-mcp 有环境变量
2. 在第一次工具调用时，如果不存在缓存的令牌，服务器会向stderr打印一个OAuth URL
3. 用户在浏览器中打开URL并授权
4. Quire重定向到 localhost:3000/callback 其中服务器捕获令牌
5. 令牌缓存到磁盘以备将来使用

令牌缓存位置：

• 窗户： %APPDATA%\quire-mcp\tokens.json
• macOS： ~/Library/Application Support/quire-mcp/tokens.json
• Linux： ~/.config/quire-mcp/tokens.json

HTTP模式

HTTP模式运行具有OAuth 2.0端点的HTTP服务器。需要时使用此功能：

• 长时间运行的服务器进程
• 多个客户端连接到同一服务器
• 部署到远程主机（例如Cloudflare Workers、云VM）

重要提示： 在HTTP模式下，服务器必须正在运行 _之前_ 客户端可以连接。环境变量设置在 服务器进程，不在客户端配置中。

在本地运行HTTP模式

第一步： 启动服务器：

# Using npx
QUIRE_OAUTH_CLIENT_ID=your-client-id \
QUIRE_OAUTH_CLIENT_SECRET=your-client-secret \
MCP_TRANSPORT=http \
npx quire-mcp

# Or using pnpm (for development)
pnpm dev:http

服务器将输出：

[quire-mcp] HTTP server listening on 127.0.0.1:3001
[quire-mcp] OAuth metadata: http://localhost:3001/.well-known/oauth-authorization-server
[quire-mcp] MCP endpoint: http://localhost:3001/mcp

第二步： 配置您的MCP客户端以连接：

{
  "mcpServers": {
    "quire": {
      "type": "http",
      "url": "http://localhost:3001/mcp"
    }
  }
}

注： 不 env HTTP模式的客户端配置中需要一个部分——OAuth凭据在服务器上。

步骤3： 当MCP客户端连接时，它将：

1. 通过以下方式发现OAuth端点 /.well-known/oauth-authorization-server
2. 将您重定向到Quire授权
3. 交换令牌并建立会话

HTTP模式环境变量

HTTP模式的Quire应用程序配置： 使用HTTP模式时，将Quire应用程序的重定向URL更新为： http://localhost:3001/oauth/callback

手动令牌模式

如果您有预先获得的访问令牌（例如，来自Postman），则可以完全跳过OAuth：

{
  "mcpServers": {
    "quire": {
      "command": "npx",
      "args": ["-y", "quire-mcp"],
      "env": {
        "QUIRE_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

注： 手动获得的令牌最终将过期，如果没有OAuth凭据，将不会自动刷新。

配置参考

所有环境变量

\*除非满足以下条件，否则必须 QUIRE_ACCESS_TOKEN 已设置。

特性

工具

服务器提供 60+工具 按类别组织：

认证

组织

项目

任务

标签

评论

用户

自定义状态

外部团队（合作伙伴）

文件

转租人

聊天频道

键值存储

通知

附件

资源

服务器将数据作为MCP资源公开：

静态资源

资源模板

提示

服务器为常见工作流提供指导性提示：

发展

设置

# Clone the repo
git clone https://github.com/jacob-hartmann/quire-mcp.git
cd quire-mcp

# Use the Node.js version from .nvmrc
# (macOS/Linux nvm): nvm install && nvm use
# (Windows nvm-windows): nvm install 22 && nvm use 22
nvm install
nvm use

# Install dependencies
pnpm install

# Copy .env.example and configure
cp .env.example .env
# Edit .env with your OAuth credentials

本地运行

# Development mode (stdio, auto-reload)
pnpm dev

# Development mode (http, auto-reload)
pnpm dev:http

# Production build
pnpm build

# Production run
pnpm start        # stdio mode
pnpm start:http   # http mode

调试

您可以使用 MCP检查员 要调试服务器，请执行以下操作：

# Run from source
pnpm inspect

# Run from built output
pnpm inspect:dist

pnpm inspect 负载 .env 自动通过 dotenv （参见 .env.example).

如果你看到 Ignored build scripts: esbuild...，跑 pnpm approve-builds 并允许 esbuild. 在CI中，我们安装依赖项时禁用了生命周期脚本(pnpm install --ignore-scripts)然后明确地仅重建 esbuild 用于生产建设工作。

贡献

欢迎投稿！请参阅 贡献.md 了解如何为这个项目做出贡献的指导方针。

安全

看 安全.md 用于安全策略和报告漏洞。

支持

这是一个“按原样”提供的社区项目 没有保证的支持。参见 支持.md 了解详情。

许可证

麻省理工学院©雅各布·哈特曼