Onlinekommentar MCP

🚀 オンラインコメンタリーMCPサーバー

onlinekommentar.ch からスイスの法律解説にアクセスできる、モデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用すると、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 の解説詳細を取得する"

基本的な使用法

検索例

英語で「憲法上の権利」に関する解説を検索する

これにより、関連する解説のID、タイトル、公開日、URLが含まれるリストが返されます。

詳細解説例

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プロトコル

このサーバーは、Model Context Protocol仕様を実装しており、以下を提供します。

• 検索および取得機能のツール登録
• 適切なエラー処理とレスポンスフォーマット
• パラメーターの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 統合フレームワークの提供
• スイスの法律コミュニティ 包括的な解説リソースの提供

⚠️ 重要提示

このツールは、情報提供を目的としてスイスの法律解説にアクセスできるようにするものです。法律上のアドバイスについては、常に資格のある法律専門家に相談してください。