使用说明
民间CRM MCP服务器
MCP服务器，用于与 民间CRM API提供16个工具，用于通过任何兼容MCP的客户端管理人员、公司、团体和笔记。
安装
- 克隆和安装依赖关系：
git clone https://github.com/fuego-wtf/folk-mcp.git
cd folk-mcp
pip install -r requirements.txt
- 使用API密钥创建.env文件：
cp .env.example .env
# Edit .env and add your Folk API key
从以下位置获取API密钥：https://folk.app/settings/developers
配置
克劳德代码
添加到您的Claude Code MCP设置中(~/.claude/settings.json 或项目 .mcp.json):
{
"mcpServers": {
"folk-crm": {
"command": "python",
"args": ["/path/to/folk-mcp/server.py"]
}
}
}
克劳德桌面版
增添 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"folk-crm": {
"command": "python",
"args": ["/path/to/folk-mcp/server.py"],
"env": {
"FOLK_API_KEY": "your_api_key_here"
}
}
}
}
如果使用.env文件，可以省略 env 块。
可用工具（共16个）
人们
| 工具 | 说明 |
|---|---|
folk_search_people |
按姓名、电子邮件、公司搜索人员 |
folk_get_person |
获取完整的人员详细信息 |
folk_create_person |
使用电子邮件、公司、组创建人员 |
folk_update_person |
更新人员字段、公司、组 |
folk_delete_person |
删除一个人 |
公司
| 工具 | 说明 |
|---|---|
folk_search_companies |
按名称搜索公司 |
folk_get_company |
获取完整的公司详细信息 |
folk_create_company |
创建集团公司 |
folk_update_company |
更新公司字段、组 |
群组
| 工具 | 说明 |
|---|---|
folk_list_groups |
列出所有组/列表 |
folk_get_group_members |
获取组成员 |
folk_add_to_group |
将人员添加到组 |
folk_remove_from_group |
从组中删除人员 |
folk_export_group |
将组导出为CSV或JSON |
备注
| 工具 | 说明 |
|---|---|
folk_add_note |
为某人添加备注 |
主要特点
- 公司链接 --在创建或更新时将人员与公司联系起来
- 组管理 --使用对象格式ID将人员/公司添加到组中
- 重试逻辑 --针对瞬态故障，采用指数回退自动重试
- 费率限制处理 --尊重
Retry-After429条回复的标题 - 输入验证 -API调用前验证的所有ID
- 分页 --大型结果集的基于光标的分页
- CSV导出 --通过Python csv模块正确转义
用法示例
将某人链接到公司
Update person per_xxx in Folk — set their company to Graphyn (com_yyy)
与公司建立联系
Create a new person in Folk: Jane Doe, jane@example.com, linked to company "Acme Corp"
搜索和导出
Export the "Potential Investors" group from Folk as CSV
添加到组
Add person per_xxx to the "Komunite" group in Folk
安全
- 从加载API密钥
.env文件（从未提交） - API调用前使用regex模式验证的所有ID
- 自动退避遵守速率限制
民间API文档
有关民间API的更多详细信息：https://developers.folk.app/
许可证
麻省理工学院