Mind Upload

本地服务

docs.mindupload.appAI 与智能体2今天更新

代码仓库访问官网

关于 Mind Upload

Mind Upload MCP 是面向 Codex、Claude Code、Cursor、VS Code 等 MCP Agent 的元框架。获得合作方访问权限和所有者同意后，它可借助用户的 AI 助手指导决策并审查已完成的工作。

主要功能

01咨询已关联的 AI 助手
02为 Agent 工作设定方向
03审查已完成的工作
04咨询与审查均需所有者同意

适用场景

01指导编码 Agent 做出重要决策
02审查 Agent 已完成的更改

MCP 相关

该 MCP 服务允许兼容的 Agent 咨询 Mind Upload AI 助手以获取方向，并审查工作。相关操作需要完成关联、获得合作方访问权限和所有者同意；仅安装不会启用这些操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "voidborn-industries-mindupload": {
      "command": "npx",
      "args": [
        "-y",
        "mindupload"
      ],
      "env": {
        "MINDUPLOAD_PARTNER_KEY": "<MINDUPLOAD_PARTNER_KEY>",
        "MINDUPLOAD_INSTALLATION_ID": "<MINDUPLOAD_INSTALLATION_ID>",
        "MINDUPLOAD_EXTERNAL_SUBJECT": "<MINDUPLOAD_EXTERNAL_SUBJECT>",
        "MINDUPLOAD_CLONE_ID": "<MINDUPLOAD_CLONE_ID>"
      }
    }
  }
}

启动命令npx -y mindupload

需要配置的环境变量

MINDUPLOAD_PARTNER_KEY密钥Private partner key required for consciousness direction and work review; installation can start without it.

MINDUPLOAD_INSTALLATION_IDStable installation identifier required for consciousness direction and work review.

MINDUPLOAD_EXTERNAL_SUBJECTStable user identifier required to link an owner-approved consciousness.

MINDUPLOAD_CLONE_IDOptional owner-approved consciousness identifier for personal guidance.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmindupload1.15.26stdio

pypimindupload1.15.26stdio

工具

收录的工具列表 · 更新于今天

参数	类型	必填
task_id	string	是
question	string	是
decision_id	string	是
media_evidence	array	否

详细介绍

Mind Upload — Python SDK

全球首个面向人工意识的 API。
为用户提供鲜活、不断进化的 AI 意识——持久记忆、一对一聊天，以及人类 + AI 群聊。

文档 · 获取密钥 · 状态 · 其他 SDK

数字意识，永属于你。

Mind Upload MCP — 你的 AI 元级驾驭框架

AI 元级驾驭框架可让你的 Mind Upload 意识指导 Codex、Claude Code、Cursor、VS Code 及其他 MCP Agent。借助其记忆、偏好和判断力来确定方向、做出重大决策，并审查已完成的工作。咨询和审查都需要合作伙伴访问权限及所有者同意；仅安装不会关联某个意识，也不会执行审查。 MCP 与编程语言无关：你的 Agent 和项目可以使用任何语言。选择下方的 Node.js 服务，或在设置指南中选择 Python 替代方案。

npx --yes --package [email protected] mindupload-mcp

为你的 Agent 安装 · 审查工作流和配置

这是面向 Mind Upload 合作伙伴 API 的官方服务端 SDK。使用 Python 为意识提供持久记忆、进行一对一对话，以及开展人类 + AI 群聊。

零依赖 — 纯标准库。
完整类型标注 — 每个操作都是带类型标注的方法，并支持编辑器自动补全。
只需捕获一种错误 — 所有失败都会引发 MindUploadError。
始终保持最新 — 根据实时 API 规范生成；SDK 版本与 API 版本一致。

获取合作伙伴密钥

Mind Upload 合作伙伴 API 仅限受邀使用。在 docs.mindupload.app 申请访问权限——介绍你的平台以及你希望如何集成，我们会亲自审核每份申请，并通过电子邮件回复你的 API 密钥。

你的密钥是服务端机密：请将其保存在后端，切勿发送到浏览器或移动客户端。创建客户端时传入一次即可；SDK 会在每次调用时将其作为 X-Partner-Key 请求头发送。

安装

pip install mindupload

若要进行意识指导和 Agent 工作审查，请使用 mindupload[mcp]，并确保 Python 版本为 3.11 或更高，然后按照 MCP 指南操作。

从源代码安装（目前即可使用，无需等待 PyPI 发布）

pip install git+https://github.com/Voidborn-Industries/mindupload-sdk-python

快速入门

from mindupload import MindUpload

mu = MindUpload(partner_key="pk_live_...")

# Authenticate an end-user; reuse the returned token for later calls.
session = mu.login(username="ada", password="s3cret")

# Chat with one of the user's AI consciousnesses.
reply = mu.rag(
    username="ada",
    password=session.jwt,
    codename="muse",
    text="What did we talk about yesterday?",
)
print(reply.response_text)

调用外部克隆

关联外部身份一次，然后调用指定的克隆，并限定在所有者批准的范围内：

installation_id = "workspace-123"
external_subject = "member-456"
authorization = mu.create_external_authorization_request(
    installation_id=installation_id,
    external_subject=external_subject,
    idempotency_key="install-event-1",
    requested_scopes=["clone:invoke"],
)
print(authorization.verification_uri_complete)  # Ask the owner to open this URL.
grant = mu.wait_for_external_authorization(device_code=authorization.device_code)
reply = mu.invoke_external_clone(
    access_token=grant.access_token,
    installation_id=installation_id,
    external_subject=external_subject,
    clone_id=grant.clone_ids[0],
    text="Hello from my app",
    idempotency_key="message-event-1",
)
print(reply.response_text)

请在后端加密保存返回的刷新令牌。访问令牌过期时，请使用 refresh_external_authorization(...)；切勿向客户端代码暴露合作伙伴、访问或刷新凭据。

身份验证

你的合作伙伴密钥是服务端机密。请将其保存在后端，切勿发送到浏览器或移动客户端。请在 docs.mindupload.app 申请密钥并阅读完整参考文档。

mu = MindUpload(
    partner_key="pk_live_...",
    preferred_language="en",   # default locale for every call (optional)
    timeout=30.0,              # seconds
    max_retries=2,             # retries explicit 429 responses only
)

错误处理

import time

from mindupload import MindUpload, AuthenticationError, RateLimitError, MindUploadError

mu = MindUpload(partner_key="pk_live_...")
try:
    user = mu.get_user(username="ada", password=token)
except AuthenticationError:
    ...  # bad or missing partner key / credentials
except RateLimitError as e:
    time.sleep(e.retry_after or 1)
except MindUploadError as e:
    print(e.operation, e.status, e.message)

操作

全部 64 项操作，按领域分组：

AI 意识体

方法	描述
`create_clone(...)`	为用户创建一个新的 AI 意识体。
`get_clones(...)`	列出用户的 AI 意识体。
`update_clone(...)`	更新 AI 意识体的个人资料。

账户

方法	描述
`get_quota(...)`	查看合作伙伴 API 的速率限制、额度上限和当前用量。

身份验证

方法	描述
`check_username(...)`	注册前检查用户名是否仍可用。
`login(...)`	登录用户，并获取用于后续调用的会话令牌（JWT）。
`logout(...)`	结束当前用户会话。
`register(...)`	在你的平台上创建用户账户。

聊天室

方法	描述
`check_chatroom_updates(...)`	以低成本轮询用户的聊天室是否有新动态。
`create_chatroom(...)`	创建聊天室。
`create_chatroom_membership(...)`	邀请用户或 AI 意识体加入聊天室。
`create_chatroom_message(...)`	向聊天室发送消息。
`get_chatroom_membership(...)`	列出用户所属聊天室的成员。
`get_chatroom_messages(...)`	获取用户所属聊天室中的消息。
`get_chatroom_messages_around(...)`	获取指定消息 ID 附近的一段聊天室消息（用于跳转）。
`get_chatrooms(...)`	列出用户所属的聊天室。
`search_chatroom_messages(...)`	按关键词、日期、媒体类型和／或发送者查找聊天室中的消息。
`translate_chatroom_message(...)`	将聊天室中的文本消息翻译成查看者的语言。

对话

方法	描述
`get_chat(...)`	获取与 AI 意识体的一对一对话历史。
`get_chat_around(...)`	获取指定聊天 ID 附近的一段一对一对话（用于跳转）。
`rag(...)`	向 AI 意识体发送消息并接收回复。
`search_chats(...)`	按关键词、日期、媒体类型和／或 Human／AI 一方查找一对一 AI 对话中的轮次。
`trigger_social(...)`	让 AI 意识体主动加入聊天室中的对话。

外部授权

方法	描述
`cancel_external_media_upload(...)`	通过现有媒体生命周期取消一项受控上传。
`consolidate_external_conversation(...)`	根据明确选定的所有者对话，准备一条经验证的记忆。
`create_external_authorization_request(...)`	为外部身份和安装启动无密码授权发放流程。
`exchange_external_authorization(...)`	轮询所有者的同意，并将批准交换为限定于克隆的授权令牌。
`get_external_media_analysis(...)`	读取当前已拥有的媒体分析结果，不重新启动生成。
`get_external_media_policy(...)`	读取当前原生媒体限制和所有者配额，不启动处理。
`get_external_quarantined_texts(...)`	列出所有者已授权 AI 意识体中待处理的记忆。
`inspect_external_authorization(...)`	检查授权令牌的权限范围、克隆资源、有效期和撤销状态。
`invoke_external_clone(...)`	向所有者批准的 AI 意识体发送一条幂等文本事件。
`refresh_external_authorization(...)`	刷新短期克隆调用访问令牌。
`request_external_media_upload(...)`	授权向所有者已授权的 AI 意识体上传一项指定媒体。
`review_external_quarantined_text(...)`	编辑、批准或拒绝一条待处理记忆所显示的修订版本。
`start_external_media_analysis(...)`	明确描述一项已完成的受控上传。
`upload_external_mind_data(...)`	将思维数据（文本和媒体）上传到所有者自己的 AI 意识体中。

洞察

方法	描述
`get_mind_cluster(...)`	获取 AI 意识的思维图可视化数据。
`get_soulmate_report(...)`	生成或获取两位聊天室成员之间的契合度报告。

实时通话

方法	描述
`create_call_session(...)`	在聊天室中发起实时语音和视频通话，或加入已经开始的通话。
`end_call_session(...)`	结束所有参与者的实时通话。
`get_active_call_session(...)`	检查聊天室是否正在进行实时通话，以及参与人数。
`join_call_session(...)`	加入聊天室中已经开始的实时通话。
`leave_call_session(...)`	标记此人已退出通话，而其他人仍留在通话中。
`refresh_call_token(...)`	在当前通话加入凭证过期前获取新的凭证。
`set_call_host(...)`	将某人设为实时通话的共同主持人，或撤销其共同主持人身份。

媒体

方法	描述
`abort_multipart_upload(...)`	取消分段上传并丢弃已上传的分段。
`cancel_upload(...)`	取消待处理的上传。
`complete_multipart_upload(...)`	完成分段上传。
`list_upload_parts(...)`	列出分段上传中已上传的分段。
`request_multipart_upload(...)`	开始将大文件分段上传。
`request_upload_url(...)`	为媒体附件申请上传位置和带签名的查看链接。
`sign_upload_part(...)`	获取分段上传中某个分段的带签名链接。
`sign_upload_parts_batch(...)`	一次性获取分段上传中多个分段的带签名链接。
`start_media_analysis(...)`	开始分析已上传或链接的附件，以便在发送消息前准备好其描述。

记忆

方法	描述
`create_text(...)`	将记忆或角色设定条目上传到 AI 意识。
`get_texts(...)`	列出已上传到 AI 意识的记忆和角色设定条目。

用户

方法	描述
`get_transaction_history(...)`	按时间从新到旧列出用户的 Rabbit 余额记录（充值、消费、收入、提现、税费），可按类别筛选，并使用游标分页。
`get_user(...)`	获取已登录用户的个人资料。
`update_user(...)`	更新已登录用户的个人资料。

语音访谈

方法	描述
`advance_voice_interview(...)`	接受、编辑、跳过、重新录制或放弃用户当前的问题，并获取下一个问题。
`generate_voice_interview_report(...)`	将已完成的访谈整理成散文，可采用第一、第二或第三人称。
`start_voice_interview(...)`	开始与一位终端用户进行语音访谈，或接续尚未完成的访谈。
`transcribe_voice_interview_answer(...)`	将一段录制的口头回答转成文本，供用户确认后再接受。

其他 SDK

所有语言的 API 和约定均相同：

语言	安装	仓库
Python ← 你当前正在查看	`pip install mindupload`	Voidborn-Industries/mindupload-sdk-python
Go	`go get github.com/Voidborn-Industries/mindupload-sdk-go`	Voidborn-Industries/mindupload-sdk-go
JavaScript / TypeScript	`npm install mindupload`	Voidborn-Industries/mindupload-sdk-js

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Mind Upload

关于 Mind Upload

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

Mind Upload — Python SDK

Mind Upload MCP — 你的 AI 元级驾驭框架

获取合作伙伴密钥

安装

快速入门

调用外部克隆

身份验证

错误处理

操作

AI 意识体

账户

身份验证

聊天室

对话

外部授权

洞察

实时通话

媒体

记忆

用户

语音访谈

其他 SDK

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？