Online Kommentar MCP Server

Online Kommentar MCP Server

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

Features

• Search Commentaries: Full-text search across legal commentaries with filtering options
• Retrieve Individual Commentaries: Get detailed content for specific legal articles
• Multi-language Support: Search in English, German, French, and Italian
• Advanced Filtering: Filter by legislative act, 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 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

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

Search Example

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

Detailed Commentary Example

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

Development

Project Structure

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

Troubleshooting

Common Issues

1. Server not appearing in Claude Desktop:
   • Check the configuration file path and syntax
   • Ensure the build directory exists and contains compiled JavaScript
   • Restart Claude Desktop after configuration changes
2. Build errors:
   • Verify Node.js version (14+ required)
   • Run npm install to ensure all dependencies are installed
   • Check for TypeScript compilation errors
3. API connection issues:
   • Verify internet connectivity
   • Check if onlinekommentar.ch is accessible
   • Review error messages in Claude Desktop logs

Debugging

To debug the MCP server:

1. Check Claude Desktop logs for error messages
2. Test the API endpoints directly using curl:
   curl "https://onlinekommentar.ch/api/commentaries?search=test"
3. Verify the build output in the build/ directory

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes and add tests
4. Commit your changes: git commit -am 'Add new feature'
5. Push to the branch: git push origin feature-name
6. Submit a pull request

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

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