JinDaGe - onlinekommentar-mcp MCP Details

article

README

🚀 在线评论MCP服务器

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

✨ 主要特性

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

📦 安装指南

前提条件

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

安装步骤

克隆仓库：

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

安装依赖：
```
npm install
```
构建项目：
```
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模式验证

数据结构

评论对象包括：

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

🔧 故障排除

常见问题

Claude Desktop中未显示服务器：
- 检查配置文件路径和语法
- 确保构建目录存在并包含编译后的JavaScript
- 配置更改后重启Claude Desktop
构建错误：
- 验证Node.js版本（需要14以上）
- 运行 npm install 以确保所有依赖项都已安装
- 检查TypeScript编译错误
API连接问题：
- 验证互联网连接
- 检查onlinekommentar.ch是否可访问
- 查看Claude Desktop日志中的错误消息

调试

要调试MCP服务器：

检查Claude Desktop日志中的错误消息

使用curl直接测试API端点：

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

🤝 贡献

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

📄 许可证

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

🛠️ 支持

如有问题和疑问：

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

🙏 致谢

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

⚠️ 重要提示

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

onlinekommentar-mcp