Surelook Holmes MCP

Surelook Holmes MCP服务器

Surelook Holmes的模型上下文协议（MCP）服务器 fastmcp 并使用SSE（服务器发送事件）传输。

先决条件

• Python 3.10+（我们推荐3.12）
• uv （可选，但建议用于依赖关系管理）

设置

1. 创建虚拟环境

使用 uv （推荐）：

   uv venv --python 3.12 .venv

或使用标准 python:

   python3 -m venv .venv

1. 再进行

   uv pip install -p .venv fastmcp supabase python-dotenv requests
   # OR
   source .venv/bin/activate
   pip install fastmcp supabase python-dotenv requests

1. 配置环境变量

创建 .env 项目根目录中的文件：

   PUBLIC_SUPABASE_URL=your_project_url
   PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY=your_public_key
   RAPIDAPI_KEY=your_rapidapi_key

运行服务器

使用配置的传输（SSE）运行服务器：

.venv/bin/python mcp_server.py

默认情况下，这将启动服务器http://127.0.0.1:8000（或fastmcp提供的类似默认端口）。

特性

• 工具:

- get_identity(identity_id)：通过ID检索特定身份。 - update_identity(identity_id, ...)：更新身份的详细信息（名称、关系状态、linkedin_url、headshot_media_url、元数据）。 - get_events(session_id)：列出与会话关联的事件。 - create_event(type, content, ...)：创建新事件（类型：“VISUAL_OBSERVATION”、“NOTES”、“AGENT_WHISPER”）。 - get_notes(identity_id)：检索特定身份的对话笔记。 - take_notes(identity_id, content)：为身份保存对话笔记。 - who_is_this(linkedin_url)：识别一个人，并使用RapidAPI从LinkedIn获取他们的最新详细信息。

• 资源:

- system://info：基本系统信息。

运输

此服务器使用 streamable_http 传输（流式HTTP）。