Mobi Mcp

笔记 Python

🚀 Mobi MCP 服务器

Mobi MCP 服务器是一个模型上下文协议（MCP）服务器，它允许与 Mobi（GitHub）的给定实例进行智能交互。

🚀 快速开始

在使用 Mobi MCP 服务器之前，你需要了解一些前提条件和安装步骤。

前提条件

Python 3.10 或更高版本（MCP 包需要）
一个正在运行的 Mobi 实例

模型上下文协议（MCP）是一种标准化的通信协议，它使 AI 模型能够与外部工具和服务进行交互。当与 Mobi 集成时，MCP 提供了几个关键优势：

AI 模型与 Mobi 功能之间的无缝交互
结构化的数据交换和命令执行
实时更新和双向通信
通过标准化接口增强自动化能力
与各种 AI 模型和服务的平台无关集成

安装步骤

克隆仓库：
```
git clone 
cd mobi-mcp
```
创建 Python 虚拟环境：
```
python3.12 -m venv .venv
```
⚠️ 重要提示 如果你没有 Python 3.10+，请先安装它：
- macOS：brew install python@3.12
激活虚拟环境：
- macOS/Linux：source .venv/bin/activate
安装依赖项：
```
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#。

`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。

0 条评论
分类：笔记