agentic_huge_data_base / wiki
页面 Cognee · 11 MCP 工具参考·DeepWiki 中文全文译文
DeepWiki 中文译文 / Cognee / 11

11 · MCP 工具参考（MCP Tools Reference）

记忆管道与知识图谱构建 · 聚焦本章的模块关系、源码依据与实现要点。

项目Cognee 章节11 状态全文译文 模块接口与服务契约、认证、权限与安全、文档对象与元数据、系统架构
项目要点页2.5 参考项目 项目章节目录Cognee DeepWiki 原始章节MCP Tools Reference 上一章10.7 下一章11.1
源码线索
  • .github/workflows/dockerhub-mcp.yml
  • Dockerfile
  • cognee-mcp/Dockerfile
  • cognee-mcp/README.md
  • cognee-mcp/entrypoint.sh
  • cognee-mcp/pyproject.toml
  • cognee-mcp/src/__init__.py
  • cognee-mcp/src/client.py
  • cognee-mcp/src/cognee_client.py
  • cognee-mcp/src/server.py
模块标签
  • 接口与服务契约
  • 认证、权限与安全
  • 文档对象与元数据
  • 系统架构
  • 智能体运行时

章节正文

MCP 工具参考

原始 DeepWiki 页面https://deepwiki.com/topoteretes/cognee/11-mcp-tools-reference

MCP 工具参考

相关源文件

本章引用的主要源码文件：

  • .github/workflows/dockerhub-mcp.yml
  • Dockerfile
  • cognee-mcp/Dockerfile
  • cognee-mcp/README.md
  • cognee-mcp/entrypoint.sh
  • cognee-mcp/pyproject.toml
  • cognee-mcp/src/__init__.py
  • cognee-mcp/src/client.py
  • cognee-mcp/src/cognee_client.py
  • cognee-mcp/src/server.py
  • cognee-mcp/uv.lock
  • cognee/alembic/versions/7c5d4e2f8a91_add_parent_user_id_to_users.py
  • cognee/modules/users/authentication/default/default_transport.py
  • cognee/modules/users/authentication/get_api_auth_backend.py
  • cognee/modules/users/authentication/get_client_auth_backend.py
  • cognee/tests/unit/test_add_parent_user_id_migration.py
  • docker-compose.yml
  • entrypoint.sh

本文档提供了 Cognee MCP 服务器暴露的所有模型上下文协议（MCP）工具的完整参考。这些工具使 AI 助手（Claude Desktop、Cursor、Cline 等）能够通过标准化的 MCP 接口与 Cognee 的知识图谱能力进行交互。

有关数据管理操作的信息，请参见数据管理工具。有关搜索和查询功能，请参见搜索和查询工具。有关部署和网络设置，请参见MCP 服务器配置。

概述

Cognee MCP 服务器实现了 FastMCP 协议 cognee-mcp/src/server.py:73，并暴露了一组镜像 Cognee 核心 API 功能的工具。服务器以两种模式之一运行：

  • 直接模式：直接导入并使用 cognee 库函数 cognee-mcp/src/cognee_client.py:64-68。
  • API 模式：通过 HTTP 请求连接到正在运行的 Cognee FastAPI 服务器（本地或云端）cognee-mcp/src/cognee_client.py:58-62。

MCP 服务器提供以下工具：

  • 数据入库与转换（cognify、remember）cognee-mcp/src/server.py:205、cognee-mcp/src/server.py:273
  • 知识图谱查询（search、recall）cognee-mcp/src/server.py:318、cognee-mcp/src/server.py:322
  • 管线监控（cognify_status）cognee-mcp/src/server.py:741
  • 交互追踪（save_interaction）cognee-mcp/src/server.py:326
  • 开发者规则管理（bootstrap_developer_rules、add_rules、get_rules、delete_rules）cognee-mcp/src/server.py:368-495

来源：cognee-mcp/src/server.py:73-77、cognee-mcp/src/cognee_client.py:31-70、cognee-mcp/README.md:38-49

MCP 服务器架构

Cognee · MCP 服务器架构 · 图 1
Cognee · MCP 服务器架构 · 图 1

MCP 服务器架构

服务器使用 FastMCP 框架 cognee-mcp/src/server.py:73 来暴露工具。每个工具都使用 @mcp.tool() 装饰器进行装饰，并返回 types.TextContent 对象。CogneeClient 类 cognee-mcp/src/cognee_client.py:31 充当桥梁，将请求路由到本地 cognee 包或通过 httpx.AsyncClient 路由到远程端点 cognee-mcp/src/cognee_client.py:62。

来源：cognee-mcp/src/server.py:73-77、cognee-mcp/src/cognee_client.py:31-70

工具执行流程

Cognee · 工具执行流程 · 图 2
Cognee · 工具执行流程 · 图 2

工具执行流程

所有工具函数都遵循特定模式以确保协议合规：它们使用 redirect_stdout(sys.stderr) cognee-mcp/src/server.py:17，因为 MCP 使用 stdout 进行通信。CogneeClient 处理认证逻辑（云端使用 X-Api-Key 和 X-Tenant-Id，本地使用 Authorization 请求头）cognee-mcp/src/cognee_client.py:70-85。

来源：cognee-mcp/src/server.py:17、cognee-mcp/src/cognee_client.py:70-149

完整工具参考

数据管理工具

这些工具处理数据的入库、后台处理以及生命周期管理。

  • cognify：入库数据并触发知识图谱生成管线。它可以处理本地文件路径或原始文本 cognee-mcp/src/server.py:205-219。
  • cognify_status：监控后台 cognify 任务的进度，按数据集名称报告错误 cognee-mcp/src/server.py:741-753。
  • save_interaction：将用户与代理的对话记录到内存中，以便后续检索 cognee-mcp/src/server.py:326。
  • list_data / get_datasets：检索现有数据集和数据项的元数据 cognee-mcp/src/server.py:498-538。
  • prune：清空内存，可选择删除所有内容（包括系统元数据）cognee-mcp/src/server.py:705。
  • bootstrap_developer_rules：自动将 .cursorrules、.cursor/rules 和 AGENT.md 索引到知识图谱中 cognee-mcp/src/server.py:368。

有关详细信息，请参见数据管理工具。

搜索和查询工具

这些工具允许代理使用多种策略从持久化内存中检索信息。

  • search：主要查询工具，支持多种 SearchType 参数，包括 GRAPH_COMPLETION、RAG_COMPLETION 和 CODE cognee-mcp/src/server.py:318。
  • recall：属于 V2 内存 API 的一部分，提供会话感知的检索功能 cognee-mcp/src/server.py:322。
  • get_log_file_location：提供轮转日志文件的路径，用于调试提取或搜索任务 cognee-mcp/src/server.py:783。

有关详细信息，请参见搜索和查询工具。

MCP 服务器配置

服务器支持多种传输和连接模式。

  • 传输方式：stdio（管道）、sse（实时流式传输）和 http（用于 Web 的可流式 HTTP）cognee-mcp/src/server.py:166-203。
  • 连接方式：直接模式（本地）与 API 模式（通过 API_URL 和 API_TOKEN）cognee-mcp/src/cognee_client.py:31-48。
  • 安全性：可通过 MCP_DISABLE_DNS_REBINDING_PROTECTION 配置 DNS 重新绑定保护，通过 MCP_CORS_ALLOW_ORIGINS 配置 CORS cognee-mcp/src/server.py:106-164。

有关详细信息，请参见MCP 服务器配置。

来源：cognee-mcp/src/server.py:73-933、cognee-mcp/src/cognee_client.py:31-339、cognee-mcp/README.md:38-49