模型上下文协议服务器

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
   

2. 再进行

   复制

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

3. 配置环境变量

   创建 .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）。