Teable SSE MCP について
Teable SSE MCPは、Teable API機能をHTTP/SSE経由で利用したいユーザー向けに、OpenAPI MCP Serverとmcp-proxyをDockerで構成します。TeableのOpenAPI定義とよく使われる機能が含まれています。
主な機能
- 01Teable OpenAPI定義を同梱
- 02HTTP/SSEでMCPを公開
- 03Dockerでコンポーネントを実行
- 04環境変数のトークンでAPI認証
活用シーン
- 01SSE経由でエージェントをTeableに接続
- 02HTTP/SSEクライアントにTeable API操作を公開
MCP 対応
TeableのOpenAPI定義に基づく機能を、HTTP/SSE経由でMCPクライアントに提供します。mcp-proxyがHTTP/SSE接続をOpenAPI MCP Server向けのstdioに変換します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Teable MCP サーバー
このセットアップでは、Docker で mcp-proxy(https://github.com/sparfenyuk/mcp-proxy)とともに OpenAPI MCP サーバー(https://github.com/snaggle-ai/openapi-mcp-server)を実行し、MCP サーバーを HTTP/SSE 経由で公開します。
teable の OpenAPI 定義があらかじめ読み込まれており、よく使われる機能が含まれています。
セットアップ
- API トークンを環境変数として設定します。
export OPENAPI_TOKEN=your_token_here
- Docker コンテナーをビルドして起動します。
docker-compose up --build
使用方法
起動すると、MCP サーバーは次の場所で利用できます。
http://localhost:8080/sse
サーバーは、ビルド時に渡された OPENAPI_TOKEN 環境変数のトークンを、API リクエストの Bearer トークンとして使用します。
設定
- OpenAPI 定義は、コンテナー内の
./teable-openapi.jsonから/app/teable-openapi.jsonにマウントされます - サーバーはポート 8080 でリッスンします
- 認証ヘッダーは OPENAPI_TOKEN 環境変数を使用して設定されます
アーキテクチャ
Client ⟷ HTTP/SSE ⟷ mcp-proxy ⟷ stdio ⟷ openapi-mcp-server
mcp-proxy は HTTP/SSE と stdio のプロトコル間で変換を行い、stdio のみをサポートする openapi-mcp-server を HTTP 経由で利用できるようにします。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。