# Online Kommentar MCP Server

A Model Context Protocol (MCP) server that provides access to Swiss legal commentaries from [onlinekommentar.ch](https://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**:
   ```bash
   git clone https://github.com/self-tech-labs/onlinekommentar-mcp.git
   cd onlinekommentar-mcp
   ```

2. **Install dependencies**:
   ```bash
   npm install
   ```

3. **Build the project**:
   ```bash
   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`

```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

### Search Example

```
Search for commentaries about "constitutional rights" in English
```

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

### Detailed Commentary Example

```
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

## 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

## 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:
   ```bash
   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](https://onlinekommentar.ch) for providing the legal commentary API
- [Model Context Protocol](https://modelcontextprotocol.io/) 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.