Swit MCP

🚀 Swit MCP(模型上下文協議)服務器

Swit MCP（模型上下文協議）服務器是一個強大的工具，它提供了與Swit平臺集成的能力，支持OAuth認證和多種Swit API操作，幫助用戶更高效地管理工作空間和消息。

  ░██████╗░██╗░░░░░░░██╗██╗████████╗  ███╗░░░███╗░█████╗░██████╗░
  ██╔════╝░██║░░██╗░░██║██║╚══██╔══╝  ████╗░████║██╔══██╗██╔══██╗
  ╚█████╗░░╚██╗████╗██╔╝██║░░░██║░░░  ██╔████╔██║██║░░╚═╝██████╔╝
  ░╚═══██╗░░████╔═████║░██║░░░██║░░░  ██║╚██╔╝██║██║░░██╗██╔═══╝░
  ██████╔╝░░╚██╔╝░╚██╔╝░██║░░░██║░░░  ██║░╚═╝░██║╚█████╔╝██║░░░░░
  ╚═════╝░░░░╚═╝░░░╚═╝░░╚═╝░░░╚═╝░░░  ╚═╝░░░░░╚═╝░╚════╝░╚═╝░░░░░

🚀 快速開始

1. Swit開發者控制檯應用註冊

1. 在 https://developers.swit.io 上創建新應用。
2. 獲取客戶端ID和客戶端密鑰。
3. 設置重定向URI為 http://localhost:3000/callback。

2. MCP客戶端配置

Claude桌面版

在 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中進行如下配置：

{
  "mcpServers": {
    "swit": {
      "command": "npx",
      "args": ["-y", "swit-mcp"],
      "env": {
        "SWIT_CLIENT_ID": "your-client-id",
        "SWIT_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

3. 認證過程

1. 在Claude桌面版中首次運行Swit工具時，OAuth Web服務器將自動啟動。
2. 運行 swit-oauth-start 工具以獲取認證URL。
3. 在瀏覽器中使用Swit賬戶登錄。
4. 令牌將自動保存，你可以使用 swit-oauth-status 命令查看令牌信息。

✨ 主要特性

🔐 OAuth管理

• swit-oauth-status：檢查OAuth認證狀態並查詢令牌信息。
• swit-oauth-start：啟動OAuth認證（返回瀏覽器認證URL）。

💼 Swit API集成

• swit-workspace-list：查詢可訪問的工作空間列表。
• swit-channel-list：查詢指定工作空間的頻道列表（支持過濾）。
• swit-message-create：向頻道發送新消息（支持文本/HTML）。
• swit-message-comment-create：在現有消息上添加評論。

🎯 使用示例：向Claude請求“告知Swit的開發團隊頻道項目進展情況”，系統將自動發送消息。

🔧 技術細節

• MCP SDK：使用模型上下文協議TypeScript SDK。
• OAuth：使用 @swit-api/oauth 包。
• 類型安全：使用Zod進行運行時類型驗證。
• Web服務器：使用Express內置Web服務器處理OAuth回調。
• 測試：使用Jest + Nock進行HTTP模擬測試。