Quip MCP Server

Quip MCP サーバー

Claude などの AI アシスタントから Quip ドキュメントを直接操作できる、Quip ドキュメント操作用の Model Context Protocol（MCP）サーバーです。

機能

• ドキュメントの読み取り：ID を指定して Quip ドキュメントの内容を取得し、表示します
• コンテンツの追記：既存のドキュメントの末尾にコンテンツを追加します
• コンテンツの先頭への追加：ドキュメントの先頭にコンテンツを追加します
• コンテンツの置換：ドキュメントの内容を更新します
• ドキュメントの作成：新規ドキュメントの作成をサポートする予定です（現在はウェブインターフェースにリダイレクトされます）

仕組み

この MCP サーバーは、Claude と Quip ドキュメントの間をつなぐブリッジとして機能します。次のように動作します。

1. MCP プロトコルを通じて Claude からリクエストを受け取ります
2. 適切なパラメーターを指定して Python スクリプト（quip_edit_fixed.py）を実行します
3. 結果を Claude に返します

前提条件

• Node.js v18 以降
• TypeScript
• quip ライブラリをインストールした Python
• 有効な Quip アクセストークン

インストール

1. このリポジトリをクローンします。

   git clone https://github.com/AvinashBole/quip-mcp-server.git
   cd quip-mcp-server
   

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

4. MCP の設定を行います。

   {
     "mcpServers": {
       "quip": {
         "command": "node",
         "args": ["path/to/quip-server/build/index.js"],
         "env": {
           "QUIP_ACCESS_TOKEN": "your-quip-access-token",
           "QUIP_BASE_URL": "https://platform.quip.com"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

使用方法

接続すると、次の MCP ツールを Claude から利用できるようになります。

• quip_read_document：スレッド ID を指定して Quip ドキュメントを読み取ります
• quip_append_content：ドキュメントにコンテンツを追記します
• quip_prepend_content：ドキュメントの先頭にコンテンツを追加します
• quip_replace_content：ドキュメントの内容を置き換えます
• quip_create_document：新しいドキュメントを作成します（現在はサポートされていません）

Claude での使用例：

<use_mcp_tool>
<server_name>quip</server_name>
<tool_name>quip_read_document</tool_name>
<arguments>
{
  "threadId": "YOUR_DOCUMENT_ID"
}
</arguments>
</use_mcp_tool>

Python スクリプトとの連携

このサーバーは、PYTHON_SCRIPT_PATH 定数で指定されたパスにある quip_edit_fixed.py という Python スクリプトを必要とします。このスクリプトは、次の操作をサポートする必要があります。

• read：ドキュメントの内容を読み取ります
• append：ドキュメントの末尾にコンテンツを追加します
• prepend：ドキュメントの先頭にコンテンツを追加します
• replace：ドキュメントの内容を更新します

ライセンス

ISC ライセンス

作成者

AvinashBole