内容
# @chaosintelligence/mcp
适用于 [混沌智能](https://chaosintelligence.com) 的 MCP 服务器 — 从 Claude、Cursor 和其他 AI 工具中访问您的 Capture 思绪和 Resonate 帖子。
## 快速开始
### Claude 代码（插件）
浏览插件 → **从 GitHub 添加市场** → `Chaos-Intelligence-Inc/chaos-mcp-server`
您将被提示设置 `CHAOS_API_KEY`。
### Claude 代码（手动）
将以下内容添加到您的项目的 `.mcp.json` 中：
```json
{
"mcpServers": {
"chaos": {
"command": "npx",
"args": ["-y", "@chaosintelligence/mcp"],
"env": {
"CHAOS_API_KEY": "chaos_您的密钥_在此"
}
}
}
}
```
### Claude 桌面版
将以下内容添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"chaos": {
"command": "npx",
"args": ["-y", "@chaosintelligence/mcp"],
"env": {
"CHAOS_API_KEY": "chaos_您的密钥_在此"
}
}
}
}
```
## 获取 API 密钥
1. 在 [chaosintelligence.com](https://chaosintelligence.com) 注册
2. 订阅 1 级
3. 进入 **设置 → API 密钥** 并生成一个密钥
4. 您的密钥将类似于 `chaos_` 后跟 32 个字符
## 可用工具
### Capture（思绪）
| 工具 | 描述 |
|------|-------------|
| `list_thoughts` | 列出带有过滤器的思绪（流、类别、日期、搜索） |
| `get_thought` | 通过 ID 获取思绪及其所有内容块 |
| `search_similar` | 相似思绪的语义搜索 |
| `search_thoughts` | 带结构化过滤器的语义搜索 |
| `list_streams` | 列出流（用于组织思绪的文件夹） |
| `get_stream` | 获取具有思绪的流 |
| `search_streams` | 按名称/描述搜索流 |
| `get_stats` | 思绪的汇总统计信息 |
| `list_recent_thoughts` | 快速访问最近的思绪 |
| `create_thought` | 捕获新的思绪（文本、图像、链接） |
### 页面
| 工具 | 描述 |
|------|-------------|
| `list_pages` | 列出带有过滤器的生成页面 |
| `get_page` | 获取具有完整内容的页面 |
| `update_page` | 编辑页面的标题、内容或描述 |
| `search_pages` | 按标题或内容搜索页面 |
### Resonate（帖子）
| 工具 | 描述 |
|------|-------------|
| `search_posts` | 公共帖子的语义搜索 |
| `list_posts` | 浏览带有过滤器和排序的帖子 |
| `get_post` | 获取帖子详情，包括投票和反应 |
| `get_post_demographics` | 人口统计投票明细 |
| `get_topic_clusters` | 热点话题与热度评分 |
| `get_my_votes` | 您的投票历史 |
| `get_my_post_performance` | 您的帖子绩效数据 |
### 实用工具
| 工具 | 描述 |
|------|-------------|
| `get_usage` | API 使用统计和速率限制 |
| `get_reactions` | 可用的反应类型 |
| `get_classifications` | 思绪分类类型 |
| `get_categories` | 可用的类别 |
## 开发
```bash
git clone https://github.com/Chaos-Intelligence-Inc/chaos-mcp-server.git
cd chaos-mcp-server
npm install --ignore-scripts
npm run build
```
使用 MCP 检查器进行测试：
```bash
CHAOS_API_KEY=chaos_您的密钥 npx @modelcontextprotocol/inspector node dist/index.js
```
## 许可证
MIT
