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 提供集成框架
• 瑞士法律界提供全面的評論資源

⚠️ 重要提示

此工具僅用於提供瑞士法律評論的信息。如需法律建議，請諮詢合格的法律專業人士。