Ontoportal MCP

OntoPortal MCP服务器

MCP（模型上下文协议）服务器，与 AgroPortal 以及更广泛的OntoPortal生态系统。

该服务器为AI代理提供了搜索、探索和与AgroPortal上可用的本体、词汇和语义资源交互的工具。

特性

• 搜索本体论：在所有或特定本体中搜索术语和类。支持高级过滤，如语言、过时类、精确匹配和属性。
• 列出本体论：检索AgroPortal中所有可用本体的列表。
• 获取版本：获取特定本体的历史和版本。
• 更新日志：访问本体版本之间的变更日志/差异数据。
• 文本注释：注释纯文本以提取语义实体并将其链接到AgroPortal本体。

需求

• Python 3.12+
• uv （建议用于依赖关系管理）

安装

此项目使用 mcp 和 fastmcp.

1. 克隆存储库：

   git clone https://github.com/your-username/ontoportal_mcp.git
   cd ontoportal_mcp

1. 使用设置环境和安装依赖项 uv:

   uv sync

1. 配置API密钥。创建一个 .env 根目录中的文件：

   # .env
   AGROPORTAL_API_KEY=your_api_key_here

用法

您可以直接为您选择的AI代理（如Claude Desktop或任何其他兼容MCP的客户端）运行MCP服务器设置。

uv run mcp run src/main.py

添加到Claude桌面

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "ontoportal": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/ontoportal_mcp",
        "mcp",
        "run",
        "src/main.py"
      ],
      "env": {
        "AGROPORTAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

发展

该项目的结构如下：

• src/main.py -MCP服务器入口点。
• src/config.py -配置和环境变量处理。
• src/clients/ontoportal_client.py -用于与AgroPortal API交互的客户端包装。
• src/tools/ontoportal_tools.py -向LLM公开的MCP工具的注册和定义。

许可证

MIT许可证