Legal MCP Server
A Model Context Protocol (MCP) compliant server for legal document analysis using Azure Blob Storage and Anthropic Claude API.
Features
- Document Management: List and retrieve pre-loaded
.txtdocuments from Azure Blob Storage - Prompt Library: Manage curated prompts for legal document analysis
- Streaming Analysis: Execute document analysis with real-time progress updates via MCP progress notifications
- MCP SSE Transport: Full compliance with MCP specification using Server-Sent Events
Prerequisites
- Node.js 18+
- Azure Storage Account with:
documents-textscontainer (for.txtdocuments)promptscontainer (for prompt library JSON)
- Anthropic Claude API key with credits
Setup
-
Clone and install dependencies:
git clone <your-repo-url> cd Legal-MCP npm install -
Configure environment variables:
cp .env.example .env # Edit .env with your actual values -
Upload initial prompt library to Azure:
# Using Azure CLI (after setting up connection) az storage blob upload \ --account-name legalmcpstore \ --container-name prompts \ --name "library.json" \ --file ./prompts/library.json \ --connection-string "$AZURE_STORAGE_CONNECTION_STRING" -
Upload documents to Azure:
# Upload `.txt` files to the documents-texts container az storage blob upload \ --account-name legalmcpstore \ --container-name documents-texts \ --name "your-document.txt" \ --file ./path/to/your-document.txt \ --connection-string "$AZURE_STORAGE_CONNECTION_STRING"
Running Locally
Development mode (with auto-reload):
npm run dev
Production mode:
npm run build
npm start
The server will start on http://localhost:3000 (or the port specified in PORT env var).
MCP Client Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"legal-mcp": {
"command": "node",
"args": ["/absolute/path/to/Legal-MCP/dist/index.js"],
"env": {
"AZURE_STORAGE_CONNECTION_STRING": "...",
"ANTHROPIC_API_KEY": "..."
}
}
}
}
Note: For SSE transport, you'll need to configure the HTTP endpoint instead. See MCP documentation for SSE client setup.
Testing with MCP Inspector
You can test the server using the MCP Inspector or any MCP-compatible client:
# Server should be running on http://localhost:3000/mcp
# Use an MCP client that supports SSE transport
Available Tools
- list_documents: Returns all available
.txtdocuments - list_prompts: Lists available analysis prompts (with optional search)
- get_prompt: Retrieves full prompt details by ID
- add_prompt: Adds a new user-contributed prompt
- execute_analysis: Executes document analysis with streaming progress updates
Project Structure
legal-mcp/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── storage/
│ │ ├── azure-blob.ts # Azure Blob Storage client
│ │ └── prompts.ts # Prompt library management
│ ├── claude/
│ │ └── client.ts # Claude API client with streaming
│ ├── tools/
│ │ ├── documents.ts # Document listing tool
│ │ ├── prompts.ts # Prompt management tools
│ │ └── execute.ts # Analysis execution tool
│ └── types.ts # Shared TypeScript types
├── prompts/
│ └── library.json # Initial prompt library
└── package.json
Deployment to Azure
See the deployment section in the original plan for Azure App Service deployment instructions.
License
ISC