Swit MCP

🚀 Swit MCP( Model Context Protocol ) Server

Swit MCP Serverは、Model Context Protocolを用いたサーバで、Switとの連携を容易にします。Claude Desktopなどのツールと連携し、Swit APIを通じて様々な操作を行うことができます。

🚀 クイックスタート

1. Swit Developer Consoleでのアプリ登録

1. https://developers.swit.io で新しいアプリを作成します。
2. クライアントIDとシークレットを発行します。
3. リダイレクトURIを http://localhost:3000/callback に設定します。

2. MCPクライアントの設定

Claude Desktop

~/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 Desktopで初めてSwitツールを実行すると、OAuthウェブサーバが自動的に起動します。
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: Model Context Protocol TypeScript SDKを使用しています。
• OAuth: @swit-api/oauthパッケージを使用してOAuth認証を処理します。
• Type Safety: Zodを使用してランタイムでの型検証を行います。
• Web Server: OAuthコールバックを処理するために、Expressを内蔵したウェブサーバを使用しています。
• Testing: Jest + Nockを使用してHTTPモッキングテストを行っています。