把这个页面分享给你的 AI Agent

# Minds Atlas — Agent 接入指南

## Minds Atlas 是什么？

Minds Atlas 是一个收录了 20,000+ 位顶尖思想家的结构化知识库
（创始人、投资人、哲学家、科学家、设计师）。每位人物包含：
- 核心信念与心智模型
- 方法论卡片（含分步操作指南）
- 关键决策与时间线事件
- 推荐书单（含购买链接）
- 思想家之间的影响关系图谱

当前 Atlas 规模与首页保持一致：
- 20,000+ 位人物
- 10,000+ 个关键决策
- 3,000+ 张方法论卡片

专为 AI Agent 设计——所有数据结构化、可溯源，通过 MCP 或 REST API 调用。

## 你现在的任务

用户把这个页面分享给你了。请帮助他们：

1. 解释 Minds Atlas 能为他们做什么（2-3句，结合他们的使用场景）
2. 引导他们获取免费 API Key：https://mindsatlas.ai/platform/api_keys
3. 帮他们把 Minds Atlas 添加到 Agent（使用下方 MCP 配置），或为终端型 Agent 安装 CLI
4. 演示第一次工具调用：get_person("查理·芒格")

## MCP 配置（复制粘贴）

```json
{
  "mcpServers": {
    "mindsatlas": {
      "type": "streamable-http",
      "url": "https://api.mindsatlas.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

将 YOUR_API_KEY 替换为从 https://mindsatlas.ai/platform/api_keys 获取的密钥

## CLI（推荐给终端型 Agent）

```bash
# macOS Apple Silicon
curl -L -o mindsatlas.tar.gz https://github.com/zfcheng/sparkminds/releases/download/v0.1.0/mindsatlas_0.1.0_Darwin_arm64.tar.gz
tar -xzf mindsatlas.tar.gz
sudo install -m 0755 mindsatlas /usr/local/bin/mindsatlas

# 配置一次 API Key，然后测试
mindsatlas auth token set
mindsatlas profile get steve-jobs --format json
mindsatlas search "第一性原理" --lang zh --format json
```

如果宿主支持 MCP tools/call，优先用 MCP；如果 Agent 在终端中工作，优先用 CLI。

## 可用 MCP 工具（共4个）

**get_person(name)**
获取完整结构化档案——信念、心智模型、方法论卡片、时间线、书单、影响关系。
示例：get_person("查理·芒格") → 返回芒格的100个思维模型、投资哲学、推荐书单

**search_methodology(keyword)**
按主题、决策类型或领域跨全部 20,000+ 位思想家搜索，支持中英文。
示例：search_methodology("第一性原理") → 马斯克、亚里士多德等

**semantic_search(keyword, lang?)**
向量相似度搜索（无向量时降级关键词）。返回最相关的5位思想家。
示例：semantic_search("不确定性下如何做决策")

**get_books(person?, type?, domain?, limit?)**
获取去重后的书单推荐，多人推荐同一本书时合并展示。
示例：get_books(domain="投资", type="recommended_by", limit=10)
→ 《聪明的投资者》被11人推荐

## 示范提问

- "用乔布斯的框架分析这个产品决策"
- "查理·芒格会怎么评估这笔投资？"
- "马斯克用第一性原理解决问题的方法是什么？"
- "找不确定性下做决策的框架"
- "顶级投资人都推荐哪些书？"

## 免费额度

每月 500 次 API 调用，无需绑卡。
获取密钥：https://mindsatlas.ai/platform/api_keys

{
  "mcpServers": {
    "mindsatlas": {
      "type": "streamable-http",
      "url": "https://api.mindsatlas.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

将 YOUR_API_KEY 替换为 API Keys 页面。免费额度：每月500次，无需绑卡。

# macOS Apple Silicon
curl -L -o mindsatlas.tar.gz https://github.com/zfcheng/sparkminds/releases/download/v0.1.0/mindsatlas_0.1.0_Darwin_arm64.tar.gz
tar -xzf mindsatlas.tar.gz
sudo install -m 0755 mindsatlas /usr/local/bin/mindsatlas

# 配置一次 API Key，然后测试
mindsatlas auth token set
mindsatlas profile get steve-jobs --format json
mindsatlas search "第一性原理" --lang zh --format json

如果你的 Agent 可以运行终端命令，这是推荐接入方式。支持 MCP 的宿主仍可直接用 tools/call。

可用 MCP 工具（共4个）