使用说明

Mind Reasoner MCP服务器

将Mind Reasoner的API与Claude Desktop和Claude Code集成在一起的MCP（模型上下文协议）服务器。这是 Mind Reasoner的第一台MCP服务器，使您能够创建数字思维，上传对话数据，并直接从Claude运行人工智能模拟。

什么是心灵推理？

Mind Reasoner是一种人工智能服务，它根据人们的对话数据（聊天记录、成绩单、文档）创建数字双胞胎。然后，这些数字双胞胎可以模拟这个人在各种场景中的思考、感受、说话和行为。

此MCP服务器使Mind Reasoner可以在Claude桌面/代码对话中访问。

特性

6个MCP工具 用于Mind Reasoner API集成
独立CLI 用于在没有Claude的情况下直接访问API
安全 API通过环境变量进行密钥处理
完成工作流程 从思维创造到模拟
TypeScript 全型安全实施

你能做什么

塑造数字思维 -用名字初始化新思维
上传数据 -上传聊天记录、PDF或DOCX文件
创建快照 -将上传的数据处理到AI模型中
检查状态 -监控快照处理
运行模拟 -提出问题并获得AI预测的答案
使用CLI -用于快速访问API的命令行工具

安装

先决条件

Node.js 18+ 已安装(在这里下载)
Mind Reasoner API密钥 从 app.mindreasoner.com
克劳德桌面 或 克劳德代码 安装

第一步：克隆或下载

git clone https://github.com/reasoner-com/mcp-server
cd mcp

或者下载并解压缩ZIP文件。

步骤2：安装依赖项

npm install

步骤3：构建

npm run build

这将TypeScript代码编译为JavaScript dist/ 文件夹。

步骤4：设置API密钥

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

# Copy the example file
cp .env.example .env

# Edit .env and add your API key
echo "MIND_REASONER_API_KEY=your_api_key_here" > .env

安全说明： 永远不要承诺你的 .env 文件到git。它已经在里面了 .gitignore.

步骤5：全球链接（可选）

要在任何地方使用CLI工具：

npm link

这使得 mr-cli 您的终端可在全球范围内使用。

配置

选择一这取决于您使用的是Claude Desktop还是Claude Code。

选项A：克劳德桌面

将此添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mind-reasoner": {
      "command": "node",
      "args": ["/absolute/path/to/mindreasoner-mcp-server/dist/index.js"],
      "env": {
        "MIND_REASONER_API_KEY": "your_api_key_here"
      }
    }
  }
}

重要提示： 替换 /absolute/path/to/mindreasoner-mcp-server 使用系统上的实际路径。

选项B：克劳德代码

将此添加到您的Claude Code配置文件中 ~/.claude.json:

{
  "mcpServers": {
    "mind-reasoner": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "--prefix",
        "/absolute/path/to/mindreasoner-mcp-server",
        "mcp-mind-reasoner"
      ],
      "env": {
        "MIND_REASONER_API_KEY": "your_api_key_here",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

重要提示：

替换 /absolute/path/to/mindreasoner-mcp-server 与你的实际路径
替换 your_api_key_here 使用Mind Reasoner API密钥
调整 PATH 匹配系统的Node.js位置

步骤6：重新启动

克劳德桌面： 退出并重新启动应用程序
克劳德代码： 重新加载窗口或重新启动

通过检查Claude中的Mind Reasoner工具来验证加载的MCP服务器。

CLI使用情况

该软件包包括一个独立的CLI工具，无需Claude即可使用。

可用命令

# Create a mind
mr-cli create "Person Name"

# Get signed upload URL
mr-cli upload-url <MIND_ID> <CONTENT_TYPE>

# Upload a file
mr-cli upload "<SIGNED_URL>" /path/to/file.vtt <CONTENT_TYPE>

# Create snapshot
mr-cli snapshot <MIND_ID> <DIGITAL_TWIN_ID> <ARTIFACT_ID>

# Check snapshot status
mr-cli status <MIND_ID> <SNAPSHOT_ID>

# Run simulation
mr-cli simulate <MIND_ID> "Your question here"

CLI示例工作流

# 1. Create mind
mr-cli create "Customer Service Rep"
# Output: Mind ID: abc-123, Digital Twin ID: def-456

# 2. Get upload URL
mr-cli upload-url abc-123
# Output: Signed URL: https://..., Artifact ID: ghi-789, Content Type: text/vtt

# 3. Upload file
mr-cli upload "https://storage.googleapis.com/..." ./transcript.vtt text/vtt

# 4. Create snapshot
mr-cli snapshot abc-123 def-456 ghi-789
# Output: Snapshot ID: jkl-012

# 5. Check status (wait for completion)
mr-cli status abc-123 jkl-012

# 6. Run simulation
mr-cli simulate abc-123 "How would you handle an angry customer?"

MCP工具参考

在Claude Desktop/Code中使用时，您可以访问6个工具：

1. `create_mind`

创造新的数字思维。

参数：

name （string，必填）-人类可读的大脑名称

退货：

{
  "id": "6eadcb0b-7d0b-416f-a18d-dd1e6776be48",
  "name": "Customer Service Rep",
  "digitalTwin": {
    "id": "aedcbe4d-dd9f-4dd8-9991-5e048fffe521"
  }
}

两者都保存 id 和 digitalTwin.id 用于后续步骤。

2. `get_signed_upload_url`

获取用于上载数据文件的安全URL。

参数：

mindId （string，必填）-来自的mind ID create_mind
contentType （字符串，可选）-MIME类型：
- text/vtt
- application/pdf
- application/vnd.openxmlformats-officedocument.wordprocessingml.document
- application/octet-stream （默认）

退货：

{
  "signedUrl": "https://storage.googleapis.com/mind-reasoner-prod/...",
  "artifactId": "e29e3da5-5495-4666-89dd-6886475d0a72",
  "contentType": "text/vtt"
}

两者都保存 signedUrl 和 artifactId 和 contentType 接下来的步骤。

3. `upload_file_to_signed_url`

将文件上传到签名的URL。

参数：

signedUrl （字符串，必填）-URL来自 get_signed_upload_url
filePath （string，必填）-文件的绝对路径
contentType （字符串，必填）-contentType from get_signed_upload_url

例子：

{
  "signedUrl": "https://assets.mindreasoner.com/...",
  "filePath": "/Users/username/Documents/transcript.vtt",
  "contentType": "text/vtt" // <-- Content type from step 2
}

退货： 成功确认

4. `create_snapshot`

将上传的数据处理到AI快照中。

参数：

mindId （字符串，必填）-步骤1中的Mind ID
digitalTwinId （字符串，必填）-步骤1中的数字孪生ID
artifactId （字符串，必填）-步骤2中的工件ID

退货：

{
  "mindAssessmentId": "f1234567-89ab-cdef-0123-456789abcdef"
}

这 mindAssessmentId 是您的快照ID。 救救它！

5. `get_snapshot_status`

检查快照是否已准备好进行模拟。

参数：

mindId （字符串，必填）-思维ID
snapshotId （字符串，必填）- mindAssessmentId 从 create_snapshot

退货：

{
  "id": "f1234567-89ab-cdef-0123-456789abcdef",
  "status": "processing"  // or "completed", "failed"
}

等待 status: "completed" 在运行模拟之前。

6. `simulate`

运行人工智能模拟来预测大脑的反应。

参数：

mindId （字符串，必填）-思维ID
selectedSimulationModel （字符串，必填）-要使用的型号：
- mind-reasoner-pro -最先进（推荐）
- mind-reasoner-standard -标准型号
scenario （对象，必填）-包含：
- message （字符串，必填）-您的问题/场景

例子：

{
  "mindId": "6eadcb0b-7d0b-416f-a18d-dd1e6776be48",
  "selectedSimulationModel": "mind-reasoner-pro",
  "scenario": {
    "message": "How would you handle a customer complaint about late delivery?"
  }
}

退货： 基于数字思维数据的人工智能生成响应

完整的工作流程指南

端到端示例

此工作流显示了如何从零到运行模拟：

第一步：创造思维

问克劳德：

“创造一个名为‘销售经理约翰’的新思维”

或者使用CLI：

mr-cli create "Sales Manager John"

输出：

Mind ID: 6eadcb0b-7d0b-416f-a18d-dd1e6776be48
Digital Twin ID: aedcbe4d-dd9f-4dd8-9991-5e048fffe521

💾 保存： Mind ID和数字孪生ID

步骤2：获取上传URL

问克劳德：

“获取mind 6edcb0b-7d0b-416f-a18d-dd1e6776be48的上传URL”

或者使用CLI：

mr-cli upload-url 6eadcb0b-7d0b-416f-a18d-dd1e6776be48

输出：

Signed URL: https://storage.googleapis.com/mind-reasoner-prod/...
Artifact ID: e29e3da5-5495-4666-89dd-6886475d0a72

💾 保存： 已签名的URL和工件ID

步骤3：上传数据文件

您需要一个包含会话数据的文件。支持的格式：

.vtt -聊天记录（WebVTT格式）
.pdf -PDF文档
.docx -Word文档

问克劳德：

“将文件/Users/me/Documents/sales_calls.vtt上传到[粘贴签名的URL]，内容类型为text/vtt”

或者使用CLI：

mr-cli upload "https://storage.googleapis.com/..." /Users/me/Documents/sales_calls.vtt text/vtt

输出：

✅ File uploaded successfully

步骤4：创建快照

这会将您上传的数据处理到AI模型中。

问克劳德：

“使用数字孪生aedcbe4d…和工件e29e3da5…为思维6edcb0b创建快照…”

或者使用CLI：

mr-cli snapshot 6eadcb0b-7d0b-416f-a18d-dd1e6776be48 aedcbe4d-dd9f-4dd8-9991-5e048fffe521 e29e3da5-5495-4666-89dd-6886475d0a72

输出：

Snapshot ID: f1234567-89ab-cdef-0123-456789abcdef

💾 保存： 快照ID

步骤5：检查快照状态

处理快照需要时间。反复检查状态，直到完成。

问克劳德：

“检查快照f1234567…的状态，以便记住6eadcb0b…”

或者使用CLI：

mr-cli status 6eadcb0b-7d0b-416f-a18d-dd1e6776be48 f1234567-89ab-cdef-0123-456789abcdef

输出：

Status: processing  // Keep checking until "completed"

⏳ 等待 status: "completed" 在继续之前。

步骤6：运行模拟

快照完成后，您可以运行模拟！

问克劳德：

“用model mind reasoner pro模拟思维6eadcb0b…并问：‘你会对想要折扣的客户说什么？’”

或者使用CLI：

mr-cli simulate 6eadcb0b-7d0b-416f-a18d-dd1e6776be48 "What would you say to a client who wants a discount?"

输出：

AI-generated response based on Sales Manager John's communication style and personality...

支持的文件类型

格式	扩展名	内容类型	用例
WebVTT	`.vtt`	`text/vtt`	聊天记录、通话记录
PDF	`.pdf`	`application/pdf`	文件、报告
Word	`.docx`	`application/vnd.openxmlformats-officedocument.wordprocessingml.document`	文件、注释

故障排除

MCP服务器未加载

问题： 工具未出现在Claude桌面/代码中

解决：

检查配置文件语法

# Validate JSON
cat ~/.claude.json | python3 -m json.tool

验证路径是否为绝对路径

# Get absolute path
cd /path/to/mindreasoner-mcp-server
pwd

检查是否设置了API密钥

# Test CLI works
mr-cli create "Test Mind"

正确重启
- 克劳德桌面：完全退出（Cmd+Q），然后重新打开
- Claude代码：使用“重新加载窗口”命令

检查日志 （macOS）

# View Claude Desktop logs
tail -f ~/Library/Logs/Claude/mcp*.log

API错误

问题： “未经授权”或“无效的API密钥”

解决方案：

在验证您的API密钥 app.mindreasoner.com
检查 .env 文件具有正确的密钥
确保配置文件具有正确的密钥（没有额外的空格）
更新密钥后重新启动Claude

问题： “404未找到”

解决方案：

Mind Reasoner的API中可能不存在终结点
查看API文档以了解支持的终结点
仅使用6个记录在案的工具

问题： “快照仍在处理中”

解决方案：

处理快照可能需要5-15分钟
继续检查状态，直到 "completed"
在快照准备就绪之前，不要运行模拟

文件上传问题

问题： 文件上传失败

解决：

检查文件路径是否为绝对路径

# Wrong
mr-cli upload "..." transcript.vtt text/vtt

# Right
mr-cli upload "..." /Users/me/Documents/transcript.vtt text/vtt

验证内容类型是否与文件扩展名匹配
- .vtt → text/vtt
- .pdf → application/pdf
- .docx → application/vnd.openxmlformats-officedocument.wordprocessingml.document
检查文件大小 （API可能有限制）
确保文件存在
```
ls -lh /path/to/your/file.vtt
```

确保内容类型与文件扩展名匹配

# Wrong
mr-cli upload-url 6eadcb0b-7d0b-416f-a18d-dd1e6776be48 text/vtt
mr-cli upload "..." /Users/me/Documents/transcript.vtt application/pdf

# Right
mr-cli upload-url 6eadcb0b-7d0b-416f-a18d-dd1e6776be48 text/vtt
mr-cli upload "..." /Users/me/Documents/transcript.vtt text/vtt

发展

项目结构

mcp/
├── src/
│   └── index.ts          # MCP server implementation
├── dist/
│   └── index.js          # Compiled JavaScript (generated)
├── cli.mjs               # Standalone CLI tool
├── package.json          # npm configuration
├── tsconfig.json         # TypeScript config
├── .env                  # Your API key (git-ignored)
├── .env.example          # Template for .env
├── .gitignore            # Ignores .env and sensitive files
└── README.md             # This file

构建命令

# Build once
npm run build

# Watch for changes and rebuild
npm run watch

# Clean build artifacts
rm -rf dist/
npm run build

进行更改

编辑TypeScript源代码：

# Edit src/index.ts or cli.mjs
nano src/index.ts

重建：
```
npm run build
```

测试MCP服务器：

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{}}}' | node dist/index.js

测试CLI：
```
mr-cli create "Test Mind"
```

添加新工具

要向MCP服务器添加新工具，请执行以下操作：

在中添加工具定义 src/index.ts:

const tools: Tool[] = [
  // ... existing tools
  {
    name: "your_new_tool",
    description: "What your tool does",
    inputSchema: {
      type: "object",
      properties: {
        param1: { type: "string", description: "..." }
      },
      required: ["param1"]
    }
  }
];

在中添加处理程序 CallToolRequestSchema 处理程序：

case "your_new_tool": {
  const params = request.params.arguments as YourParamsType;
  // Implementation
}

重建和测试

安全最佳实践

API密钥保护

✅ 做：

将API密钥存储在 .env 文件
添加 .env 到 .gitignore
在配置中使用环境变量
永远不要在源代码中硬编码密钥

❌ 不要：

提交 .env 转git
公开共享您的API密钥
硬编码键入代码
将密钥上传到GitHub

文件权限

API费率限制

Mind Reasoner API可能有费率限制。如果你达到了极限：

间隔请求
尽可能缓存结果
联系Mind Reasoner支持以获得更高的限制

高级用法

在其他项目中使用

在另一个项目中本地安装：

cd /path/to/your/project
npm install /path/to/mindreasoner-mcp-server

然后在Node.js中使用：

import { createMind, simulate } from 'mcp-mind-reasoner';

const mind = await createMind("Test Mind");
const result = await simulate(mind.id, "mind-reasoner-pro", {
  message: "Your question"
});

环境变量

您可以使用环境变量覆盖默认值：

# Set API key
export MIND_REASONER_API_KEY="your_key"

# Run CLI
mr-cli create "Mind Name"

或者在自己的代码中使用dotenv：

import dotenv from 'dotenv';
dotenv.config();

资源

Mind Reasoner仪表板： app.mindreasoner.com
API文件： docs.reasoner.com/mind-reasoner-api
MCP协议： 模型上下文协议.io
克劳德桌面： claude.ai

支持

对于问题或疑问：

心智推理者API： support@mindreasoner.com
此MCP服务器： 在GitHub上打开一个问题
MCP协议： Anthropic的MCP Discord

常见问题解答

Q：我需要在某个地方主持这个吗？

A. 不！MCP服务器在您的计算机上本地运行。当您使用服务器时，Claude Desktop/Code会自动启动服务器。

Q：我可以和其他人分享吗？

A. 对！其他人可以：

克隆您的仓库
安装依赖项
添加他们自己的API密钥
配置他们的Claude桌面/代码

每个人都使用自己的API密钥运行自己的副本。

Q： Mind Reasoner存储哪些数据？

A. Mind Reasoner存储您上传的文件和您创建的思维。有关详细信息，请查看Mind Reasoner的隐私政策。

Q：我可以删除一个想法吗？

A. 不通过此MCP服务器（API不支持通过公共端点）。使用Mind Reasoner网络仪表板删除头脑。

Q：快照需要多长时间？

A. 通常为5-15分钟，具体取决于文件大小和Mind Reasoner的处理队列。

Q：我可以同时使用多个思维吗？

A. 对！每个思维都有自己的ID。您可以创建任意数量的ID（受思维推理者的限制）。

贡献

欢迎投稿！贡献：

分叉回购
创建要素分支
进行更改
彻底测试
提交拉取请求

请遵循现有的代码样式，并为新功能添加测试。

更新日志

v1.0.0（2025-10-25）

初始版本
6 Mind Reasoner API的MCP工具
独立CLI工具
Claude桌面和Claude代码支持
TypeScript实现
全面的文件

许可证

MIT许可证-有关详细信息，请参阅许可证文件

致谢

内置 MCP-SDK
由...驱动心理咨询师API
为克劳德桌面/代码社区创建

由以下材料制成❤️ 为心灵推理者和克劳德社区

使用说明

Mind Reasoner MCP服务器

什么是心灵推理？

特性

你能做什么

安装

先决条件

第一步：克隆或下载

步骤2：安装依赖项

步骤3：构建

步骤4：设置API密钥

步骤5：全球链接（可选）

配置

选项A：克劳德桌面

选项B：克劳德代码

步骤6：重新启动

CLI使用情况

可用命令

CLI示例工作流

MCP工具参考

1. create_mind

2. get_signed_upload_url

3. upload_file_to_signed_url

4. create_snapshot

5. get_snapshot_status

6. simulate

完整的工作流程指南

端到端示例

第一步：创造思维

步骤2：获取上传URL

步骤3：上传数据文件

步骤4：创建快照

步骤5：检查快照状态

步骤6：运行模拟

支持的文件类型

故障排除

MCP服务器未加载

API错误

文件上传问题

发展

项目结构

构建命令

进行更改

添加新工具

安全最佳实践

API密钥保护

文件权限

API费率限制

高级用法

在其他项目中使用

环境变量

资源

支持

常见问题解答

Q： 我需要在某个地方主持这个吗？

Q： 我可以和其他人分享吗？

Q： Mind Reasoner存储哪些数据？

Q： 我可以删除一个想法吗？

Q： 快照需要多长时间？

Q： 我可以同时使用多个思维吗？

贡献

更新日志

v1.0.0（2025-10-25）

许可证

致谢

相关 MCP

英雄联盟模拟比赛预测器

AI增强观测模拟平台

NBA赔率数据服务器

AI现实模拟工具包

多模态生成API服务

Rhino与Grasshopper AI控制MCP服务

1. `create_mind`

2. `get_signed_upload_url`

3. `upload_file_to_signed_url`

4. `create_snapshot`

5. `get_snapshot_status`

6. `simulate`

Q：我需要在某个地方主持这个吗？

Q：我可以和其他人分享吗？

Q：我可以删除一个想法吗？

Q：快照需要多长时间？

Q：我可以同时使用多个思维吗？