Mobi MCP

🚀 Mobi MCP Server

このサーバーは、Model Context Protocol (MCP) サーバーであり、Mobi (GitHub) の特定のインスタンスとエージェント型のインターフェースを提供します。

🚀 クイックスタート

このセクションでは、Mobi MCP Server のセットアップと使用方法を説明します。

前提条件

• Python 3.10 以上 (MCP パッケージに必要)
• 実行中の Mobi インスタンス

Model Context Protocol (MCP) は、AI モデルが外部のツールやサービスと相互作用できるようにする標準化された通信プロトコルです。Mobi と統合すると、MCP はいくつかの重要な利点を提供します。

• AI モデルと Mobi の機能とのシームレスな相互作用
• 構造化されたデータ交換とコマンド実行
• リアルタイム更新と双方向通信
• 標準化されたインターフェースを通じた自動化機能の強化
• 様々な AI モデルとサービスとのプラットフォーム非依存の統合

インストール

1. リポジトリをクローンする:

   git clone <repository-url>
   cd mobi-mcp
   

2. Python 仮想環境を作成する:

   python3.12 -m venv .venv
   

   注意: Python 3.10+ がインストールされていない場合は、最初にインストールしてください。

   • macOS: brew install python@3.12

3. 仮想環境をアクティブ化する:

   • macOS/Linux: source .venv/bin/activate

4. 依存関係をインストールする:

   pip install -r requirements.txt
   

MCP サーバーの利用

このサーバーをすぐに試す最も簡単な方法は、MCP サーバーを Claude Desktop に接続し、次のような JSON スニペットを使用して ~/Library/Application\ Support/Claude/claude_desktop_config.json ファイルを変更して、アプリケーションが MCP サーバーを使用するように設定することです。

{
  "mcpServers": {
    "mobi": {
      "command": "/Users/{username}/git/mobi-mcp/.venv/bin/python",
      "args": ["/Users/{username}/git/mobi-mcp/src/mobi-mcp.py"],
      "env": {
        "MOBI_BASE_URL": "https://localhost:8443",
        "MOBI_USERNAME": "admin",
        "MOBI_PASSWORD": "admin",
        "MOBI_IGNORE_CERT": "true"
      }
    }
  }
}

-- 注意: 絶対パスが必要なため、パスを調整する必要があります :)

Claude Desktop は stdio MCP トランスポートを利用していますが、このサーバーは SSE もサポートしています ( mobi-mcp の Python スクリプトを --sse 引数で実行することができます)。

また、これは Mobi のインスタンスが実行されていることを前提としています。ローカルで実行したい場合は、こちら の手順を参照してください。

設定

MCP サーバーには、以下の環境変数が必要です。

リポジトリ構造

リポジトリは、Mobi API の相互作用レイヤーと Model Context Protocol の実装を明確に分離するように構成されています。

• src/mobi.py - 認証、API 呼び出し、データ処理を担当する Mobi API クライアントのコア機能を含む
• src/mobi-mcp.py - Mobi の機能と Model Context Protocol を橋渡しする主要な MCP サーバーの実装
• Dockerfile - MCP サーバーのコンテナ化されたデプロイを可能にする
• Makefile - 環境設定とコンテナ管理のための便利なコマンドを提供する
• requirements.txt - プロジェクトに必要なすべての Python パッケージの依存関係をリストする

現在のツール

Mobi MCP Server は、Mobi インスタンスと相互作用するための以下のツールを公開しています。

検索と発見ツール

record_search

指定された条件に一致するレコードを Mobi カタログで検索します。

• パラメーター:
  • offset (int): ページネーションの開始インデックス
  • limit (int): 取得するレコードの最大数
  • search_text (str, オプション): レコード内で検索するテキスト
  • keywords (list[str], オプション): レコードと一致させるキーワード
  • types (list[str], オプション): フィルタリングするレコードタイプ。有効なタイプ:
    • http://mobi.com/ontologies/ontology-editor#OntologyRecord (オントロジー/語彙)
    • http://mobi.com/ontologies/shapes-graph-editor#ShapesGraphRecord (SHACL)
    • http://mobi.com/ontologies/delimited#MappingRecord (マッピング)
    • http://mobi.com/ontologies/dataset#DatasetRecord (データセット)

entity_search

メタデータに指定された文字列が含まれるレコードを Mobi カタログで検索します。

• パラメーター:
  • search_for (str): エンティティのメタデータ内で検索する部分文字列
  • offset (int): 結果セット内の開始位置
  • limit (int): 返すエンティティの最大数
  • types (list[str], オプション): フィルタリングするエンティティタイプ
  • keywords (list[str], オプション): フィルタリングするキーワード

データ取得ツール

fetch_ontology_data

指定されたオントロジーレコードの IRI のオントロジーデータを取得します。

• パラメーター:
  • ontology_iri (str): オントロジーデータを含むレコードの IRI (オントロジーの IRI ではない)
• 注意: 検索結果のレコード IRI を使用してください。通常は https://mobi.com/records#<uuid> の形式です。

get_shapes_graph

指定されたレコードの形状グラフを取得します。

• パラメーター:
  • record_id (str): レコードの一意の識別子
  • branch_id (str, オプション): レコード内のブランチ識別子
  • commit_id (str, オプション): ターゲットとするコミット識別子

コンテンツ作成ツール

create_ontology_record

RDF データとメタデータから新しいオントロジーレコードを作成します。

• パラメーター:
  • rdf_string (str): RDF データの文字列
  • rdf_format (str): RDF データの形式 (例: "xml", "turtle")
  • title (str): オントロジーのタイトル
  • description (str): オントロジーのテキスト説明
  • markdown_description (str, オプション): 説明の Markdown バージョン
  • keywords (list[str], オプション): オントロジーに関連付けられたキーワード
• 注意: 新しいレコードを作成する前に、ユーザーの確認を得ることをお勧めします。

バージョン管理ツール

create_branch_on_record

既存のレコードに新しいブランチを作成します。

• パラメーター:
  • record_iri (str): レコードの IRI
  • title (str): 新しいブランチのタイトル
  • description (str): 新しいブランチの説明
  • commit_iri (str): 参照として使用するコミットの IRI

使用上の注意

• すべてのツールは Mobi の git ベースのバージョニングシステムと相互作用します。
• レコードの IRI は通常、検索操作から返されます。
• サーバーは git リポジトリと同様のセマンティックバージョニングの慣習に従います。
• 書き込み操作を実行する前に、常にレコードとブランチの IRI を確認してください。