内容
# Neuron
Neuron 读取您的 Slack 工作区，并建立一个关于公司规则、决策和流程的动态知识库。您可以通过网页界面或直接通过 MCP 从 Claude Desktop 查询它，这样您的 AI 总是知道公司实际的运作方式。
## 功能
- **Slack 同步** — 读取消息历史并使用 GPT-4o 提取知识
- **语义搜索** — Pinecone 矢量存储支持基于相似性的查询
- **冲突检测** — 标记与现有知识相矛盾的新项目
- **MCP 服务器** — Claude Desktop 可以直接查询和写入知识库
- **API 密钥身份验证** — 机器间访问，无需 Clerk 会话
- **第 1 周报告** — 提取知识的自动化电子邮件摘要
- **4 步 onboarding** — 新用户引导设置
## 快速入门
```bash
# 1. 克隆并安装
git clone https://github.com/nameisalii/neuron_mcp.git
cd neuron_mcp
npm install
# 2. 复制环境变量模板并填写值
cp .env.production.example .env.local
# 3. 设置数据库
npx prisma migrate deploy
# 4. 启动开发服务器
npm run dev
# 5. 打开 http://localhost:3000 并注册
```
## 环境变量
| 变量 | 描述 |
|---|---|
| `DATABASE_URL` | PostgreSQL 连接字符串 |
| `OPENAI_API_KEY` | 用于 GPT-4o 提取和嵌入 |
| `PINECONE_API_KEY` | 矢量存储 |
| `PINECONE_INDEX` | Pinecone 索引名称 |
| `CLERK_SECRET_KEY` | Clerk 后端密钥 |
| `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` | Clerk 前端密钥 |
| `CLERK_WEBHOOK_SECRET` | Clerk webhook 验证 |
| `SLACK_CLIENT_ID` | Slack OAuth 应用客户端 ID |
| `SLACK_CLIENT_SECRET` | Slack OAuth 应用客户端密钥 |
| `SLACK_SIGNING_SECRET` | Slack 请求签名 |
| `ENCRYPTION_KEY` | 32 字节十六进制密钥用于令牌加密 (`openssl rand -hex 32`) |
| `RESEND_API_KEY` | 电子邮件投递 |
| `NEXT_PUBLIC_APP_URL` | 部署 URL |
| `NEURON_API_KEY` | MCP / API 密钥身份验证的 Bearer 令牌 (`openssl rand -hex 32`) |
| `NEURON_WORKSPACE_ID` | 用于 API 密钥身份验证的工作区 ID |
## MCP 设置（Claude Desktop）
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"neuron": {
"command": "npm",
"args": ["run", "mcp"],
"cwd": "/path/to/neuron_mcp",
"env": {
"NEURON_API_URL": "http://localhost:3000",
"NEURON_API_KEY": "your-api-key-here"
}
}
}
}
```
对于已部署的应用，请将 `NEURON_API_URL` 替换为您的 Vercel URL。
**可用工具：**
- `query_company_brain` — 提问，获取来源答案
- `get_company_context` — 完整的已验证知识库（markdown 格式）
- `save_decision` — 直接将决策写入知识库
参见 [mcp/README.md](mcp/README.md) 以获取完整的设置说明。
## 部署
参见 [DEPLOYMENT.md](DEPLOYMENT.md) 以获取逐步的 Vercel 指南。
**在线演示：** https://neuron-mcp.vercel.app *(替换为您的 URL)*
## 技术栈
| 层 | 技术 |
|---|---|
| 框架 | Next.js 14 (App Router) |
| 身份验证 | Clerk |
| 数据库 | PostgreSQL + Prisma |
| 矢量 | Pinecone |
| 大型语言模型 | OpenAI GPT-4o |
| Slack | `@slack/web-api` |
| 电子邮件 | Resend |
| MCP | `@modelcontextprotocol/sdk` |
| 部署 | Vercel |
