Onlinekommentar MCP

🚀 Online Kommentar MCP Server

A Model Context Protocol (MCP) server that offers access to Swiss legal commentaries from onlinekommentar.ch. It enables users to search for and retrieve detailed legal commentaries on Swiss federal law via Claude Desktop or other MCP-compatible clients.

🚀 Quick Start

This Model Context Protocol (MCP) server allows access to Swiss legal commentaries from onlinekommentar.ch. You can search and retrieve detailed legal commentaries on Swiss federal law through Claude Desktop or other MCP-compatible clients.

✨ Features

• Search Commentaries: Conduct full-text searches across legal commentaries with filtering options.
• Retrieve Individual Commentaries: Obtain detailed content for specific legal articles.
• Multi-language Support: Search in English, German, French, and Italian.
• Advanced Filtering: Filter by legislative act and sort by title or date.
• Pagination Support: Navigate through large result sets.

📦 Installation

Prerequisites

• Node.js (version 14 or higher)
• npm or yarn package manager
• Claude Desktop (for MCP integration)

Setup

1. Clone the repository:

   git clone https://github.com/self-tech-labs/onlinekommentar-mcp.git
   cd onlinekommentar-mcp
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

💻 Usage Examples

Usage with Claude Desktop

Configuration

Add the following configuration to your Claude Desktop MCP settings file:

• On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "online-kommentar": {
      "command": "node",
      "args": ["/path/to/onlinekommentar-mcp/build/index.js"]
    }
  }
}

Replace /path/to/onlinekommentar-mcp with the actual path to your project directory.

Restart Claude Desktop

After adding the configuration, restart Claude Desktop to load the MCP server.

Available Tools

1. Search Commentaries

Search for legal commentaries using various filters.

• Parameters:
  • search (required): Full-text search query
  • language (optional): Content language (en, de, fr, it)
  • legislative_act (optional): Filter by legislative act ID
  • sort (optional): Sort order (title, -title, date, -date)
  • page (optional): Page number for pagination
• Example queries:
  • "Search for commentaries about intellectual property"
  • "Find German commentaries about data protection"
  • "Search for articles related to criminal law, sorted by date"

2. Get Commentary by ID

Retrieve detailed information about a specific commentary using its ID.

• Parameters:
  • id (required): The unique identifier of the commentary
• Example:
  • "Get commentary details for ID: 6d8aee6b-86d0-43f2-8110-2d5b7360dd18"

Examples

Basic Usage

Search for commentaries about "constitutional rights" in English

This will return a list of relevant commentaries with their IDs, titles, publication dates, and URLs.

Advanced Usage

Get the full content of commentary ID: 7058f7a5-19d8-444e-a901-7bb635ded375

This will return comprehensive information including:

• Full title and publication details
• Authors and editors
• Legislative act information
• Complete commentary content
• Legal text being commented on

📚 Documentation

Development

Project Structure

onlinekommentar-mcp/
├── src/
│   └── index.ts          # Main MCP server implementation
├── build/                # Compiled JavaScript output
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

Available Scripts

• npm run build: Compile TypeScript to JavaScript
• npm start: Run the compiled server (for testing)

API Integration

The server integrates with the onlinekommentar.ch API:

• Base URL: https://onlinekommentar.ch/api
• Endpoints:
  • /commentaries - Search commentaries
  • /commentaries/{id} - Get specific commentary

🔧 Technical Details

MCP Protocol

This server implements the Model Context Protocol specification, providing:

• Tool registration for search and retrieval functions
• Proper error handling and response formatting
• JSON schema validation for parameters

Data Structure

Commentary objects include:

• Unique identifiers
• Multilingual titles and content
• Author and editor information
• Legislative act associations
• Publication dates and metadata
• Direct links to online versions

📄 License

This project is open source. Please refer to the license file for details.

Support

For issues and questions:

• Open an issue on GitHub
• Check the troubleshooting section above
• Review the MCP protocol documentation

Acknowledgments

• onlinekommentar.ch for providing the legal commentary API
• Model Context Protocol for the integration framework
• Swiss legal community for comprehensive commentary resources

⚠️ Important Note

This tool provides access to Swiss legal commentaries for informational purposes. Always consult qualified legal professionals for legal advice.