@muzie/mcp-server

MCP Server for Hiyve AI-powered meeting intelligence.

Overview

The @muzie/mcp-server package provides AI-powered meeting intelligence through the Model Context Protocol (MCP). Query your meetings, recordings, transcriptions, and collaboration networks using natural language through Claude Desktop or custom integrations.

Quick Start: Hosted Server

Connect Claude Desktop to our hosted MCP servers with zero setup:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hiyve": {
      "url": "https://mcp.us-east-1.hiyve.tech/mcp",
      "transport": "streamable-http"
    }
  }
}

Restart Claude Desktop, authenticate via the browser popup, and start querying:

"Show my rooms"
"Summarize my last meeting"
"Who do I collaborate with most?"

See Hosted Server Guide for more details.

Features

10 MCP Tools - Natural language interface for meetings, search, and actions
28 Primitive Functions - Underlying data access and processing
Smart Routing - Automatic routing of queries to optimal handlers
Agent Orchestration - Multi-step AI reasoning for complex queries
OAuth 2.1 - Secure authentication for Claude Desktop
Multi-tenant Security - Built-in organization isolation

Transports

Transport	Status	Use Case
Streamable HTTP	Recommended	Claude Desktop, modern clients
SSE	Deprecated	Legacy clients
Stdio	Available	Local development

Authentication Methods

Method	Use Case
OAuth 2.1	Claude Desktop (automatic)
MCP Token	External API access (64-char hex)
Email + API Key	Internal services

See Authentication Guide for details.

MCP Tools

Tool	Description
`natural_query`	Recommended - Routes queries to optimal handler
`query_data`	Query meeting data using natural language
`agent_query`	Multi-step AI reasoning for complex questions
`summarize_meeting`	AI-powered meeting summaries
`search_content`	Semantic search across transcriptions/files
`query_meeting_context`	Analyze meeting mood and sentiment
`start_meeting`	Start instant meeting or create room
`create_room`	Create persistent room
`create_schedule`	Schedule future meeting
`cancel_schedule`	Cancel scheduled meeting

See Tools Reference for complete documentation.

Self-Hosting

For development or enterprise deployments:

npm install @muzie/mcp-server --registry=https://s3.us-east-1.amazonaws.com/muzie.media/npm-registry/

import { createMCPServer } from '@muzie/mcp-server';
import { Room, Schedule, Recording, UserProfile } from 'muziertc-models';

const mcp = createMCPServer({
  models: { Room, Schedule, Recording, UserProfile },
  services: { UnifiedAIService, AISearchService },
  aiConfig: { openaiKey: process.env.OPENAI_API_KEY }
});

export const { toolHandlers, buildSecurityContext } = mcp;

See Getting Started for complete setup.

Documentation

Using the Server

Hosted Server Guide - Connect to hosted servers
Getting Started - Quick start and self-hosting
Tools Reference - All tools and primitives

Technical Reference

Authentication - OAuth 2.1, tokens, API keys
HTTP Transport - Streamable HTTP and SSE
Architecture - System design and routing

API Documentation

# Generate JSDoc documentation
npm run docs

# Generate and preview at http://localhost:3031
npm run docs:serve

Environment Variables

Variable	Required	Description
`MONGODB_URI`	Yes	MongoDB connection string
`OPENAI_API_KEY`	Yes*	OpenAI API key
`XAI_API_KEY`	No	xAI/Grok API key (fallback)
`BASE_URL`	No	Server base URL (for OAuth)

*Either OPENAI_API_KEY or XAI_API_KEY is required for AI features.

Architecture

@muzie/mcp-server
├── HTTP Transport        # Streamable HTTP + SSE endpoints
├── OAuth 2.1             # Authentication with PKCE
├── SmartRouter           # Query routing and analysis
├── MCPAgentOrchestrator  # Multi-step AI reasoning
├── toolHandlers          # 28 primitive tool functions
└── Security Context      # Multi-tenant authorization

Support

Documentation: docs/
Issues: GitHub Issues
Email: support@hiyve.tech

Hiyve MCP Server

Home