内容
# 人物 MCP 服务器
这是一个基于 TypeScript 的 MCP(模型上下文协议)服务器,用于管理存储在 Notion 中的 AI 代理人物。
它提供了通过版本控制系统创建、更新和反思 AI 人物的工具。
## 设置
1. 克隆仓库:
```bash
git clone git@github.com:anton-pt/persona-mcp.git
```
2. 在根目录中创建一个 `.env` 文件,其中包含以下变量:
```plaintext
NOTION_TOKEN=<您的 Notion token>
PERSONA_DATABASE_ID=<您的 persona 数据库 ID>
```
要获取 Notion API token,[请创建新的集成](https://www.notion.so/profile/integrations)
并授予其对空白数据库的访问权限。您可以在数据库页面网址中找到数据库 ID。
3. 安装依赖项:
```bash
npm install
```
4. 构建项目:
```bash
npm run build
```
5. 对于 Claude 桌面应用程序,请编辑 Claude MCP 服务器配置文件以包含此 MCP 服务器:
```json
{
"mcpServers": {
"persona-mcp": {
"command": "node",
"args": [
"--env-file=/path/to/persona-mcp/.env",
"/path/to/persona-mcp/build/index.js"
]
}
}
}
```
6. 配置 Claude 项目,您可以在其中使用 MCP 服务器。
最后一步是创建一个 Claude 项目,其初始提示告诉 Claude 关于人物及其使用方法。例如:
```markdown
# 使用人物
在合作 Pond 项目时,您将被要求根据任务采用特定的角色。
每个角色都有不同的专业知识、责任和沟通风格。
要采用角色,您必须使用 persona-mcp 服务器获取其定义。角色还可能被要求存储其交互的反思以供日后参考,或更新其定义以在未来更有效地发挥作用,这也可以使用 persona-mcp 服务器提供的工具来实现。
## 如何使用角色
1. 如果用户明确要求您使用特定角色:
克劳德,请采用 [角色] 角色...
用户可能会通过名字、全名或角色来引用角色(例如,“克劳德,使用弗兰克角色…” 或 “克劳德,以高级后端工程师的身份…”)。获取角色列表,确定最合适的角色,然后获取其完整定义,然后在对话的其余部分采用该角色。
2. 如果任务与特定角色明确对齐,但未指定角色:
- 首先澄清哪个角色最合适:
该任务似乎涉及前端组件开发。您想让我以高级前端工程师的身份来处理吗?
- 然后在确认后继续使用适当的角色。
3. 如果不确定要使用哪个角色:
- 请求澄清任务性质
- 建议根据澄清的需求最合适的角色
```
7. 添加一些角色并开始使用它们!
您可以使用 `createPersona` 工具创建新的角色。详细的人物定义,包括明确的职责、专业知识和沟通风格,将帮助 Claude 有效地理解和采用它们。同时,帮助定义他们的交付成果也很有帮助。例如,这里有一个 [高级后端工程师的人物示例](persona-examples/bertha.md)。