民间CRM MCP服务器
 
MCP（模型上下文协议）服务器，提供对以下内容的访问 民间CRM 功能，允许AI助手管理联系人、公司、笔记、提醒等。
特性
- 智能搜索：以最少的令牌使用量按名称查找人员和公司
- 两阶段查找：快速搜索返回ID，然后根据需要获取完整的详细信息
- 联系人管理：创建、更新和删除人员和公司
- 备注和提醒：为您的联系人添加上下文
- 交互日志记录：跟踪电子邮件、会议和电话
- 内置技能资源：服务a
skill://folk/usage教LLM正确的工具路由、ID格式规则和情境处理模式的资源
添加到克劳德代码
来自注册表（已发布）
# Configure your Folk API key
mpak config set @nimblebraininc/folk api_key=your_api_key_here
# Add to Claude Code
claude mcp add folk -- mpak run @nimblebraininc/folk本地开发
# Clone and enter the repo
git clone https://github.com/NimbleBrainInc/mcp-folk.git
cd mcp-folk
# Install dependencies
uv sync
# Build the bundle
make pack
# Configure your API key
mpak config set @nimblebraininc/folk api_key=your_api_key_here
# Add to Claude Code (use absolute path)
claude mcp add folk -- mpak run --local /path/to/mcp-folk/mcp-folk-0.1.0-darwin-arm64.mcpb配置
获取民间API密钥
- 登录您的Folk工作区
- 首选 设置>API
- 创建新的API密钥
- 复制密钥并配置
mpak config set
可用工具
搜索（先使用）
| 工具 | 目的 |
|---|---|
find_person(name) | 按姓名查找人员，返回 {found, matches: [{id, name, email}]} |
find_company(name) | 按名称查找公司，返回 {found, matches: [{id, name, industry}]} |
详细信息（查找后）
| 工具 | 目的 |
|---|---|
get_person_details(person_id) | 包括所有字段的完整人员信息 |
get_company_details(company_id) | 完整的公司信息，包括所有字段 |
浏览
| 工具 | 目的 |
|---|---|
browse_people(page, per_page) | 所有人的分页列表 |
browse_companies(page, per_page) | 所有公司的分页列表 |
分组和筛选
| 工具 | 目的 |
|---|---|
list_groups() | 列出工作区中的所有组 |
find_people_in_group(group_name, status) | 查找组中的人员，可选择按状态筛选 |
find_companies_in_group(group_name, status) | 查找组中的公司，可选择按状态筛选 |
行动
| 工具 | 目的 |
|---|---|
add_person(first_name, ...) | 创建新用户 |
add_company(name, ...) | 创建新公司 |
update_person(person_id, ...) | 更新人员字段 |
update_company(company_id, ...) | 更新公司字段 |
delete_person(person_id) | 删除一个人 |
delete_company(company_id) | 删除公司 |
备注和提醒
| 工具 | 目的 |
|---|---|
add_note(person_id, content) | 向人员添加注释 |
get_notes(person_id) | 获取个人笔记 |
set_reminder(person_id, reminder, when) | 设置提醒 |
log_interaction(person_id, type, when) | 记录交互 |
效用
| 工具 | 目的 |
|---|---|
whoami() | 获取当前经过身份验证的用户 |
常见用例
查找联系人
- “Sarah Chen在我的CRM中吗？”
- “找到Acme Corp的所有人”
- “约翰的电子邮件是什么？”
会后添加联系人
- “加上今天会议上的迈克·约翰逊，他是Stripe的项目经理”
- “为创建联系人lisa@example.com"
记笔记
- “给Sarah添加一条注释：讨论了Q2路线图，她对企业计划感兴趣”
- “我对Acme交易有什么看法？”
设置后续行动
- “提醒我下周二和约翰联系”
- “设置提醒，在两周内与Sarah联系”
日志交互
- “记录我今天和迈克通了电话”
- “记录我与Acme团队的会面”
浏览联系人
- “显示我最近的联系人”
- “列出我的CRM中的所有公司”
查询组和管道
- “在‘演示管理’中显示状态为‘跟进1’的线索”
- “列出我的投资者组中的所有人”
- “在我的客户组中查找活跃客户”
- “我在民间有什么团体？”
示例流程
User: "I just had coffee with Alex Rivera, she's interested in our API. Remind me to send her docs next week."
AI: find_person("Alex Rivera")
→ {"found": true, "matches": [{"id": "abc123", "name": "Alex Rivera", "email": "alex@techco.io"}]}
AI: add_note("abc123", "Had coffee - interested in API, wants to see docs")
→ {"id": "note456", "added": true}
AI: log_interaction("abc123", "meeting", "2024-01-15T10:00:00Z")
→ {"id": "int789", "logged": true}
AI: set_reminder("abc123", "Send API docs to Alex", "2024-01-22T09:00:00Z")
→ {"id": "rem012", "set": true}
AI: "Done! I've added a note about your coffee chat, logged the meeting, and set a reminder for next Monday to send her the API docs."发展
# Install dev dependencies
uv sync --dev
# Run tests
uv run pytest tests/ -v
# Format code
uv run ruff format .
# Lint
uv run ruff check .
# Type check
uv run mypy src/
# Run all checks
make check
# Build bundle for testing
make packAPI 参考
此服务器使用 民间REST API.关键端点：
- 基本URL:
https://api.folk.app/v1 - 身份验证：承载令牌
- 适用费率限制（见民间文件）
许可证
麻省理工学院