MCP.so
ログイン

Matrix MCP Server

@mjknowles

基本情報

カテゴリ

その他

ライセンス

MIT

トランスポート

stdio

作者

mjknowles

Matrix MCP Server について

Matrix ホームサーバーと連携するための MCP サーバーです。チャットやルーム管理などが行えます。

Matrix MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "matrix-mcp-server": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

Matrix MCP Server のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

上のボタンで一時的なサンドボックスでこのサーバーを実行し、ツール一覧を取得できます。

概要

matrix-mcp-server とは?

Matrix ホームサーバーの機能に安全にアクセスできる、包括的な Model Context Protocol(MCP)サーバーです。TypeScript で構築されており、MCP クライアントが標準化されたインターフェースを通じて Matrix のルーム、メッセージ、ユーザーなどを操作できるようにします。

matrix-mcp-server の使い方

npm で依存関係をインストールしてプロジェクトをビルドし、.env ファイルで環境変数を設定してから、npm start でサーバーを起動します。クライアントは HTTP トランスポートで接続し、ヘッダーで Matrix のユーザー ID、ホームサーバーの URL、アクセストークン(または OAuth)を渡します。認証モードは、本番向けの OAuth モードとテスト向けの開発モードの 2 つがあります。

matrix-mcp-server の主な機能

  • トークン交換に対応した OAuth 2.0 認証
  • 機能レベル別に整理された 15 個の Matrix ツール
  • エンドポイントを設定できる複数ホームサーバー対応
  • 一時的なクライアント管理によるリアルタイム操作
  • 充実したエラー処理と入力検証
  • 詳細な Matrix データを含むリッチなレスポンス

matrix-mcp-server のユースケース

  • ユーザーが参加しているルームを一覧表示し、ルームの詳細を取得する
  • メッセージやダイレクトメッセージを送信し、ルームのメンバーを管理する
  • 公開ルームを検索し、日付範囲でメッセージを絞り込む
  • メッセージ数からルーム内で最も活発なユーザーを特定する
  • Matrix ルームの作成、参加、退出、管理を行う

よくある質問

1

OAuth モードとは何ですか?どのような場合に使うべきですか?

OAuth モードはアイデンティティプロバイダーとの完全な OAuth 2.0 連携を行い、Matrix ホームサーバーの認証のためのトークン交換に対応しています。本番環境へのデプロイに推奨されます。

2

実行環境の要件は何ですか?

Node.js 20 以上と npm、Matrix ホームサーバー(Synapse、Dendrite など)へのアクセス、そして Claude Desktop や MCP 拡張機能を入れた VS Code などの MCP クライアントが必要です。

3

ユーザーやルームのデータはどこに保存されますか?

すべてのデータは Matrix ホームサーバー上にあります。サーバーは一時的な Matrix クライアントを作成し、認証、操作の実行、後片付けを自動で行います。ローカルにデータが保存されることはありません。

4

権限やセキュリティはどのように扱われますか?

Matrix クライアントはすべて一時的なもので、OAuth によってトークンが直接露出することを防ぎます。ルームのパワーレベルや権限は尊重され、入力検証には Zod スキーマが使われます。CORS も設定可能です。

5

OAuth を使わずに matrix-mcp-server を利用できますか?

はい。開発モード(ENABLE_OAUTH=false)では Matrix のアクセストークンを直接使えますが、本番環境での利用は推奨されません。

コメント

「その他」の他のコンテンツ