JinDaGe - kanta-mcp-server MCP Details

article

README

🚀 Kanta MCP服务器

Kanta MCP服务器是一个用于Kanta API的Model Context Protocol（MCP）服务器，可实现与Claude等语言模型的集成，为AI助手与Kanta数据交互提供支持。

🚀 快速开始

Kanta MCP服务器通过MCP协议公开Kanta v1.1 API的功能，使AI助手能够与Kanta数据进行交互，实现以下功能：

管理客户（创建、更新、搜索、分配）
管理用户
查看人员数据
获取事务所和机构的信息
获取风险摘要

✨ 主要特性

客户管理

get_customers：分页列出客户
get_customer：按ID获取客户
create_customer：创建新客户
update_customer：更新现有客户
search_customers：搜索客户
assign_customers：分配监管人员/贡献者
get_customer_risk_summary：获取风险摘要

用户管理

get_users：列出用户
get_user：按ID获取用户
create_user：创建新用户
delete_user：删除用户

人员管理

get_persons：列出人员
get_person：按ID获取人员

其他功能

get_firms：列出事务所
get_structure：获取机构信息

📦 安装指南

通过Smithery安装

要通过 Smithery 为Claude Desktop自动安装kanta-mcp-server，请运行以下命令：

npx -y @smithery/cli install @Kanta-Inc/kanta-mcp-server --client claude

手动安装

克隆仓库：

git clone <repository-url>
cd kanta-mcp-server

安装依赖：

npm install

编译TypeScript：

npm run build

📚 详细文档

环境变量要求

KANTA_API_KEY：您的Kanta API密钥（必需）
KANTA_API_URL：API的基本URL（可选，默认值：https://app.kanta.fr/api/v1）

获取API密钥

要获取您的Kanta API密钥，请按以下步骤操作：

登录到 https://app.kanta.fr
进入“事务所管理”
选择“API密钥”
生成或复制您的API密钥

💻 使用示例

启动服务器

# 使用npm
KANTA_API_KEY=your_api_key npm start

# 或在开发环境中使用tsx
KANTA_API_KEY=your_api_key npm run dev

MCP配置

将以下配置添加到您的MCP客户端（如Claude Desktop）：

{
  "mcpServers": {
    "kanta": {
      "command": "node",
      "args": ["/chemin/vers/kanta-mcp-server/dist/index.js"],
      "env": {
        "KANTA_API_KEY": "votre_cle_api_ici"
      }
    }
  }
}

🔧 技术细节

可用脚本

npm run build：编译TypeScript
npm start：启动编译后的服务器
npm run dev：使用tsx以开发模式启动
npm run watch：以监听模式启动进行开发

项目结构

src/
├── index.ts              # 主入口点
├── types.ts              # 类型定义和Zod模式
├── kanta-client.ts       # Kanta API的HTTP客户端
└── tools/
    ├── customers.ts      # 客户管理工具
    ├── users.ts          # 用户管理工具
    ├── persons.ts        # 人员管理工具
    └── misc.ts           # 其他工具（事务所、机构、文件）

Kanta API

此服务器使用Kanta v1.1 API。有关API的更多信息：

基本URL：https://app.kanta.fr/api/v1
身份验证：通过X-API-Key头部使用API密钥
完整文档可在api-docs.json文件中找到

📄 许可证

本项目采用MIT许可证。

支持

有关Kanta API的问题，请查阅Kanta官方文档。如果遇到与该MCP服务器相关的问题，请在此仓库中创建一个issue。

⚠️ 重要提示

文件上传/下载功能不可用（MCP限制）
所有操作都需要有效的Kanta API密钥
主要关注CRUD操作和JSON数据查询

kanta-mcp-server