项目简介

Kanta MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在将法国企业数据管理平台 Kanta 的 API 功能封装成 LLM（大型语言模型）友好的上下文资源和可调用工具。它允许像 Claude Desktop 这类支持 MCP 的 LLM 客户端直接访问 Kanta 的客户、用户、人员、机构数据，并执行相关操作，从而自动化和增强 AI 助手在企业数据管理方面的能力。

主要功能点

• 客户管理: 支持列出、获取、创建、更新、搜索客户，以及分配客户给监督者/贡献者，并获取客户的风险摘要。
• 用户管理: 能够列出、获取、创建和删除系统用户。
• 人员管理: 提供列出和获取特定人员信息的功能。
• 机构与结构信息: 访问公司机构列表和组织结构详情。
• 上下文资源提供: 以标准 JSON 格式提供组织结构和客户摘要等关键业务数据作为可供 LLM 读取的资源。
• API 集成: 通过封装 Kanta API v1.1，确保与 Kanta 平台数据的无缝交互。

安装步骤

1. 克隆仓库:

   git clone https://github.com/Kanta-Inc/kanta-mcp-server
   cd kanta-mcp-server
   

2. 安装依赖:

   npm install
   

3. 构建服务器 (可选，推荐用于部署):

   npm run build
   

服务器配置

MCP 客户端（如 Claude Desktop 结合 Smithery）需要以下配置来连接 Kanta MCP 服务器。用户只需在 Smithery 界面填写对应的配置参数即可，无需手动编写 JSON 代码。

• API 密钥 ('apiKey'): 您的 Kanta 平台的 API 密钥，用于认证对 Kanta API 的访问。这是必填项。
  • 获取方式：登录 https://app.kanta.fr -> "Gestion du cabinet" -> "Clés API" -> 生成或复制您的 API 密钥。
• API URL ('apiUrl'): Kanta API 的基础 URL。这是可选项，默认值为 'https://app.kanta.fr/api/v1'。

基本使用方法

• 通过 Smithery 安装 (推荐用于 Claude Desktop): 在您的终端运行以下命令，Smithery 会引导您完成安装和配置过程，包括输入您的 Kanta API 密钥。

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

• 本地运行 (开发模式):

  # 确保已设置 KANTA_API_KEY 环境变量，或在 Smithery 配置中提供
  npm run dev
  

  服务器将在开发模式下启动，并通过标准输入/输出 (Stdio) 协议与 MCP 客户端通信。
• 本地运行 (生产构建):

  npm start
  

  服务器将运行生产构建版本。

一旦服务器运行并通过 MCP 客户端连接，LLM 即可通过调用服务器暴露的工具和访问资源来与 Kanta 数据进行交互。