Skip to content

Releases: mjknowles/matrix-mcp-server

Matrix MCP Server v0.1.0

20 Aug 04:09
@mjknowles mjknowles
v0.1.0
2a631d7

Choose a tag to compare

View all tags
Matrix MCP Server v0.1.0 Latest
Latest

Matrix MCP Server v0.1.0 🚀

Initial release of Matrix MCP Server - A TypeScript Model Context Protocol server for Matrix homeserver integration

🎯 What's New

Core Features

  • OAuth2 Authentication with Keycloak integration and token exchange
  • Matrix Homeserver Integration via matrix-js-sdk
  • Production-Ready MCP Server with HTTP transport and streaming support
  • Comprehensive Matrix Tools for room and user management

Available MCP Tools (11 total)

Room Management

  • list-joined-rooms - Get all joined rooms with member counts
  • get-room-info - Detailed room information including encryption status
  • search-public-rooms - Find and discover public Matrix rooms

Messaging & Communication

  • get-room-messages - Retrieve recent messages from any room
  • get-messages-by-date - Filter messages by date ranges
  • get-direct-messages - Access DM conversations with unread counts

User & Member Management

  • get-room-members - List room members with display names
  • identify-active-users - Find most active users by message count
  • get-user-profile - Complete user profiles with presence status
  • get-my-profile - Own account information and settings
  • get-all-users - Directory of all known Matrix users

Notifications

  • get-notification-counts - Unread message and mention tracking

🔧 Technical Highlights

  • TypeScript Implementation with comprehensive type safety
  • Cached Matrix Clients for improved performance
  • Environment-based Configuration supporting multiple deployment modes
  • CORS & Security headers for production use
  • Rate Limiting Protection and graceful error handling
  • OAuth Token Exchange for secure Matrix authentication
  • HTTPS Support with configurable SSL certificates

🚦 Authentication Modes

  • OAuth Mode: Full OAuth2 flow with Keycloak integration
  • Development Mode: Direct token authentication for testing
  • Token Exchange: Automatic token conversion for Matrix compatibility

📦 Installation & Setup

git clone https://github.com/mjknowles/matrix-mcp-server.git
cd matrix-mcp-server
npm install
npm run build
npm start

🔗 Integration Support

- Claude Code: Full MCP integration with authentication
- MCP Inspector: Development and testing support
- VSCode: Configuration examples provided
- Custom MCP Clients: Standard HTTP transport compatibility

📋 Requirements

- Node.js 20+
- Matrix homeserver (Synapse, Dendrite, etc.)
- Optional: Keycloak or compatible OAuth2 provider

🧪 Testing Status

✅ All 11 MCP tools fully tested and working
✅ Authentication flows validated
✅ Rate limiting and error handling verified
✅ Production deployment ready

---
Matrix MCP Server bridges the gap between Matrix's decentralized messaging protocol and modern AI assistants through the standardized Model Context Protocol.
Assets 2
Loading