Onlinekommentar MCP

🚀 在线评论MCP服务器

这是一个模型上下文协议（MCP）服务器，可让你从 onlinekommentar.ch 访问瑞士法律评论。通过Claude Desktop或其他支持MCP的客户端，你可以使用该服务器搜索和获取有关瑞士联邦法律的详细法律评论。

✨ 主要特性

• 搜索评论：可对法律评论进行全文搜索，并具备过滤选项。
• 获取单条评论：获取特定法律条文的详细内容。
• 多语言支持：支持使用英语、德语、法语和意大利语进行搜索。
• 高级过滤：可按立法法案进行过滤，按标题或日期排序。
• 分页支持：可在大量搜索结果中进行导航。

📦 安装指南

前提条件

• Node.js（版本14或更高）
• npm或yarn包管理器
• Claude Desktop（用于MCP集成）

安装步骤

1. 克隆仓库：

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

2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

🚀 快速开始

与Claude Desktop配合使用

配置

将以下配置添加到Claude Desktop的MCP设置文件中：

• 在macOS上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在Windows上：%APPDATA%/Claude/claude_desktop_config.json

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

请将 /path/to/onlinekommentar-mcp 替换为你项目目录的实际路径。

重启Claude Desktop

添加配置后，重启Claude Desktop以加载MCP服务器。

💻 使用示例

可用工具

1. 搜索评论

使用各种过滤器搜索法律评论。 参数：

• search（必需）：全文搜索查询
• language（可选）：内容语言（en、de、fr、it）
• legislative_act（可选）：按立法法案ID过滤
• sort（可选）：排序顺序（title、-title、date、-date）
• page（可选）：分页页码

示例查询：

• "搜索有关知识产权的评论"
• "查找有关数据保护的德语评论"
• "搜索与刑法相关的文章，按日期排序"

2. 按ID获取评论

使用评论的ID检索特定评论的详细信息。 参数：

• id（必需）：评论的唯一标识符

示例：

• "获取ID为 6d8aee6b-86d0-43f2-8110-2d5b7360dd18 的评论详细信息"

代码示例

基础用法

Search for commentaries about "constitutional rights" in English

此查询将返回相关评论的列表，包含评论的ID、标题、发布日期和URL。

高级用法

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

此查询将返回全面的信息，包括：

• 完整标题和发布详情
• 作者和编辑信息
• 立法法案信息
• 完整评论内容
• 所评论的法律文本

📚 详细文档

开发

项目结构

onlinekommentar-mcp/
├── src/
│   └── index.ts          # 主要的MCP服务器实现
├── build/                # 编译后的JavaScript输出
├── package.json          # 项目依赖和脚本
├── tsconfig.json         # TypeScript配置
└── README.md            # 本文件

可用脚本

• npm run build：将TypeScript编译为JavaScript
• npm start：运行编译后的服务器（用于测试）

API集成

该服务器与onlinekommentar.ch API集成：

• 基础URL：https://onlinekommentar.ch/api
• 端点：
  • /commentaries - 搜索评论
  • /commentaries/{id} - 获取特定评论

🔧 技术细节

MCP协议

该服务器实现了模型上下文协议规范，提供：

• 搜索和检索功能的工具注册
• 适当的错误处理和响应格式
• 参数的JSON模式验证

数据结构

评论对象包括：

• 唯一标识符
• 多语言标题和内容
• 作者和编辑信息
• 立法法案关联
• 发布日期和元数据
• 在线版本的直接链接

🔧 故障排除

常见问题

1. Claude Desktop中未显示服务器：

   • 检查配置文件路径和语法
   • 确保构建目录存在并包含编译后的JavaScript
   • 配置更改后重启Claude Desktop

2. 构建错误：

   • 验证Node.js版本（需要14以上）
   • 运行 npm install 以确保所有依赖项都已安装
   • 检查TypeScript编译错误

3. API连接问题：

   • 验证互联网连接
   • 检查onlinekommentar.ch是否可访问
   • 查看Claude Desktop日志中的错误消息

调试

要调试MCP服务器：

1. 检查Claude Desktop日志中的错误消息
2. 使用curl直接测试API端点：

   curl "https://onlinekommentar.ch/api/commentaries?search=test"
   

3. 验证 build/ 目录中的构建输出

🤝 贡献

1. 分叉仓库
2. 创建功能分支：git checkout -b feature-name
3. 进行更改并添加测试
4. 提交更改：git commit -am 'Add new feature'
5. 推送到分支：git push origin feature-name
6. 提交拉取请求

📄 许可证

本项目为开源项目。详情请参考许可证文件。

🛠️ 支持

如有问题和疑问：

• 在GitHub上创建问题
• 查看上述故障排除部分
• 查看MCP协议文档

🙏 致谢

• onlinekommentar.ch 提供法律评论API
• Model Context Protocol 提供集成框架
• 瑞士法律界提供全面的评论资源

⚠️ 重要提示

此工具仅用于提供瑞士法律评论的信息。如需法律建议，请咨询合格的法律专业人士。