AI Context Flow

Plurality MCP Server

为 AI Agent 和工具提供通用记忆。随时随地保存、整理和搜索上下文。

一个 Model Context Protocol 服务，为任何兼容 MCP 的 AI 客户端提供持久记忆——文档、笔记、对话和文件存储在井然有序的记忆区中，并支持语义搜索。支持基于 OAuth 和个人访问令牌（PAT）的身份验证。

为什么使用它？

• Memory Studio — 个人知识库和第二大脑，可将上下文整理到记忆区、查看已保存的内容，并管理 AI Agent 所掌握的信息。
• 保存重要聊天 — 可直接在 Claude、ChatGPT、Cursor 和其他 AI 工具中，将聊天保存到相关记忆区
• 所有 Agent 共享持久记忆 — Claude Code、Lovable、Cursor、OpenClaw 等都能访问相同的上下文
• 语义搜索 — 使用自然语言查找相关记忆，而不仅仅依赖关键词
• 与他人共享记忆区 — 允许他人访问你的上下文，实现协作
• 随处可用 — 任何兼容 MCP 的客户端都能连接

我们还提供名为 AI Context Flow 的 Chrome 扩展，让你能够在任何网站上捕获和使用上下文。它内置了一个聊天 Agent（支持 30 多种模型），可在任何页面以侧边栏形式打开——与记忆对话、根据已存储的上下文回答问题，并发现你保存的所有内容之间的关联。你可以将 MCP Server 与扩展配合使用，体验产品的完整功能集。

▶️ 观看演示

📖 完整文档 · 🌐 网站 · 🧩 Chrome 扩展 · 🧠 Memory Studio

快速连接（生产环境）

生产环境 URL：https://app.plurality.network/mcp

服务支持 OAuth 2.1 with PKCE（适用于交互式客户端）和个人访问令牌（适用于无头 Agent 和 CI）。大多数客户端会自动处理 OAuth 流程。

适用于 Claude Desktop、Claude Code、ChatGPT、Cursor 以及任何兼容 MCP 的客户端。

→ 所有受支持客户端的分步设置指南

工具

身份验证

MCP 服务支持两种身份验证方式：

使用个人访问令牌

1. 登录控制面板，打开 Connect via MCP → Manage tokens
2. 点击 Create token，为令牌命名并设置可选的过期时间，然后复制 plur_pat_… 值
3. 将客户端配置为以 Bearer 令牌的形式发送该令牌：

Authorization: Bearer plur_pat_...

PAT 需要付费计划。PAT 会在过期时自动撤销，可在配置宽限期后轮换（默认 7 天），也可立即从控制面板撤销。PAT 以哈希形式存储，绝不会出现在日志中。

OAuth 详情

服务器使用 Ory Hydra 作为 OAuth2/OIDC 提供方：

架构

MCP Client (Claude Code, Cursor, etc.)
    │
    │  OAuth2 + Streamable HTTP
    ▼
Traefik (:5050)           ← single entrypoint for clients
    ├── /mcp              → MCP Server (:5051)
    ├── /.well-known/*    → API Gateway or Hydra
    ├── /oauth2/*         → Hydra (:4444)
    └── /register         → API Gateway (DCR proxy)
                                │
                                │ Bearer token
                                ▼
                          API Gateway (:5000)
                                │
                                ▼
                          Vector Service (:8000)

Traefik 是唯一入口。它将 OAuth 流量路由到 Hydra，并将 MCP 协议流量路由到 MCP 服务。MCP 服务使用 Hydra 的 JWKS 密钥在本地验证 JWT，然后将 Bearer 令牌转发到 API Gateway 以访问数据。API Gateway 负责身份验证、DCR 代理，并将向量/搜索操作路由到 Vector Service。

本地开发环境设置

先决条件

• Python 3.11+
• uv（Python 包管理器）
• Docker 和 Docker Compose
• 正在运行的 API Gateway（plurality-backend-api）：负责身份验证、OAuth 元数据、DCR 代理和数据库访问
• 正在运行的 Vector Service（plurality-ai-service）：负责语义搜索和向量数据库操作

1. 安装依赖项

cd plurality-mcp-server
pip install uv
uv sync

2. 配置环境

cp .env.example .env

本地开发可使用默认值——如果 API Gateway 在 :5000 端口运行，则无需更改：

HYDRA_ISSUER=http://localhost:5050
MCP_RESOURCE_URL=http://localhost:5050
BACKEND_API_URL=http://localhost:5000

3. 启动 Docker 服务（Hydra + Traefik）

cd ory-hydra
docker compose up -d

这将启动：

等待服务运行正常：docker compose ps

4. 启动 MCP 服务

uv run uvicorn main:mcp_server --host 0.0.0.0 --port 5051 --reload

使用端口 5051，而不是 5050。Traefik 监听 5050，并将 /mcp 代理到运行在 5051 端口的 MCP 服务。

5. 验证

# Health check (direct)
curl http://localhost:5051/mcp/health

# OAuth metadata (via Traefik)
curl http://localhost:5050/.well-known/oauth-protected-resource

# Traefik dashboard (for debugging routes)
open http://localhost:8080

本地客户端配置

claude mcp add --transport http plurality-memory http://localhost:5050/mcp

{
  "mcpServers": {
    "plurality-memory": {
      "type": "http",
      "url": "http://localhost:5050/mcp"
    }
  }
}

{
  "mcpServers": {
    "plurality-memory": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:5050/mcp"]
    }
  }
}

npx @modelcontextprotocol/inspector

注意： 本地开发不支持 ChatGPT，因为它需要可公开访问的 OAuth 端点。

项目结构

plurality-mcp-server/
├── main.py                             # Entry point
├── pyproject.toml                      # Dependencies (managed by uv)
├── .env.example                        # Environment template
├── src/plurality_mcp_server/
│   ├── app.py                          # FastMCP app + middleware stack
│   ├── config.py                       # Env vars, shared HTTP client, context vars
│   ├── auth.py                         # JWT validation via Hydra JWKS + scope check
│   └── tools.py                        # MCP tool definitions (read + write)
└── ory-hydra/
    ├── docker-compose.yml              # Hydra + Traefik + PostgreSQL
    ├── hydra.yml                       # Hydra OAuth2/OIDC config
    ├── traefik.yml                     # Traefik static config
    └── dynamic.yml                     # Traefik routing rules

故障排除

链接

• 📖 文档
• 🌐 网站
• 🧩 Chrome 扩展
• 🧠 Memory Studio
• 📦 MCP Registry
• 🔧 Smithery