Mobi MCP

🚀 Mobi MCP 服務器

Mobi MCP 服務器是一個模型上下文協議（MCP）服務器，它允許與 Mobi（GitHub）的給定實例進行智能交互。

🚀 快速開始

在使用 Mobi MCP 服務器之前，你需要了解一些前提條件和安裝步驟。

前提條件

• Python 3.10 或更高版本（MCP 包需要）
• 一個正在運行的 Mobi 實例

模型上下文協議（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 服務器連接到 Claude Desktop 是快速嘗試此服務器的最簡單方法。然後，通過修改 ~/Library/Application\ Support/Claude/claude_desktop_config.json 文件，使用如下 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）（你可以使用 --sse 參數運行 mobi-mcp Python 腳本）。

這也假設你正在運行一個 Mobi 實例。如果你想在本地運行一個實例，請參閱 此處 的說明。

📚 詳細文檔

配置

MCP 服務器需要以下環境變量：

• MOBI_BASE_URL：你的 Mobi 實例的基本 URL（例如，https://localhost:8443）
• MOBI_USERNAME：用於 Mobi 身份驗證的用戶名
• MOBI_PASSWORD：用於 Mobi 身份驗證的密碼
• MOBI_IGNORE_CERT：設置為 "true" 以忽略 SSL 證書驗證（適用於自簽名證書）

倉庫結構

倉庫的組織方式確保了 Mobi API 交互層與 MCP 協議實現之間的清晰分離：

• src/mobi.py：包含核心 Mobi API 客戶端功能，處理身份驗證、API 調用和數據處理
• src/mobi-mcp.py：主要的 MCP 服務器實現，將 Mobi 功能與模型上下文協議連接起來
• Dockerfile：支持 MCP 服務器的容器化部署
• Makefile：提供方便的命令用於環境設置和容器管理
• requirements.txt：列出項目所需的所有 Python 包依賴項

當前工具

Mobi MCP 服務器提供了以下工具，用於與你的 Mobi 實例進行交互：

搜索和發現工具

record_search

在 Mobi 目錄中搜索符合指定條件的記錄。

• 參數：
  • offset（整數）：分頁的起始索引
  • limit（整數）：要檢索的最大記錄數
  • search_text（字符串，可選）：在記錄中搜索的文本
  • keywords（字符串列表，可選）：與記錄匹配的關鍵字
  • types（字符串列表，可選）：按記錄類型過濾。有效類型包括：
    • 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（字符串）：在實體元數據中搜索的子字符串
  • offset（整數）：結果集中的起始點
  • limit（整數）：要返回的最大實體數
  • types（字符串列表，可選）：按實體類型過濾
  • keywords（字符串列表，可選）：按關鍵字過濾

數據檢索工具

fetch_ontology_data

獲取給定本體記錄 IRI 的本體數據。

• 參數：
  • ontology_iri（字符串）：包含本體數據的記錄的 IRI（不是本體 IRI 本身）

⚠️ 重要提示 使用搜索結果中的記錄 IRI，通常格式為 https://mobi.com/records#<uuid>。

get_shapes_graph

檢索指定記錄的形狀圖。

• 參數：
  • record_id（字符串）：記錄的唯一標識符
  • branch_id（字符串，可選）：記錄內的分支標識符
  • commit_id（字符串，可選）：要定位的提交標識符

內容創建工具

create_ontology_record

從 RDF 數據和元數據創建新的本體記錄。

• 參數：
  • rdf_string（字符串）：作為字符串的 RDF 數據
  • rdf_format（字符串）：RDF 數據的格式（例如，"xml"，"turtle"）
  • title（字符串）：本體的標題
  • description（字符串）：本體的文本描述
  • markdown_description（字符串，可選）：描述的 Markdown 版本
  • keywords（字符串列表，可選）：與本體關聯的關鍵字

⚠️ 重要提示 建議在創建新記錄之前與用戶確認。

版本控制工具

create_branch_on_record

在現有記錄上創建新分支。

• 參數：
  • record_iri（字符串）：記錄的 IRI
  • title（字符串）：新分支的標題
  • description（字符串）：新分支的描述
  • commit_iri（字符串）：用作參考的提交的 IRI

使用注意事項

• 所有工具都與 Mobi 的類 Git 版本控制系統進行交互。
• 記錄 IRI 通常從搜索操作中返回。
• 服務器遵循類似於 Git 倉庫的語義版本控制實踐。
• 在執行寫操作之前，始終驗證記錄和分支的 IRI。