Kili科技MCP服务器
A. 模型上下文协议（MCP） 提供交互工具的服务器 基利科技的 使用您自己的API密钥访问平台。
特点/功能
这个MCP服务器提供了三个主要工具：
- 列出项目 - 从您的Kili组织中检索所有项目名称和ID
- 查找项目 - 使用模糊匹配按名称搜索项目（在不知道确切名称时非常有用）
- 统计项目资产 - 统计特定项目中的资产数量（可通过项目名称或ID进行操作）
所有工具都需要您的Kili API密钥作为第一个参数，以确保无状态操作的安全性。
先决条件
- Python 3.8或更高版本
- 一个Kili Technology账户
- 一个Kili API密钥（见 创建API密钥）
安装
- 克隆或导航到此仓库：
cd /Users/maximekili/Desktop/tooling/MCP/mcp_repo- 安装所需的依赖项：
pip install -r requirements.txt- 获取您的Kili API密钥 （必填）：
您需要有效的Kili API密钥才能访问您组织的数据。您可以通过遵循以下步骤获取一个 创建API密钥 指南。
注你将把此API密钥作为每个工具调用的第一个参数传递。
使用方法
运行服务器
启动MCP服务器：
# Run the server
python server.py服务器将启动并准备好接收MCP协议消息和工具调用。
替代方案您也可以使用 FastMCP 命令行界面 (CLI) 来运行服务器：
fastmcp run server.py使用工具
所有工具都需要您的Kili API密钥作为第一个参数。调用任何工具时，只需传入您的API密钥即可：
# Example usage
list_projects("your_kili_api_key_here")
find_project("your_kili_api_key_here", "image labeling")
count_project_assets("your_kili_api_key_here", project_name="My Project")可用工具
1. 列出项目
列出您在Kili组织中的所有项目。
返回值：
[
{
"id": "project_id_1",
"title": "My First Project"
},
{
"id": "project_id_2",
"title": "My Second Project"
}
]3. 查找项目（find_project）
使用模糊匹配按名称搜索项目。当你只知道项目名称的大概时，这非常有用。
参数：
project_name(字符串)：要搜索的项目名称（可以是部分或近似名称）limit（整数，可选）：要返回的最大结果数量（默认：5）
返回值：
[
{
"id": "project_id_1",
"title": "Image Labeling Project",
"similarity_score": 95.5
},
{
"id": "project_id_2",
"title": "Image Quality Labeling",
"similarity_score": 78.2
}
]4. 统计项目资产
统计特定项目中的资产数量。您可以通过名称（推荐）或ID来识别该项目。
参数：
project_name（字符串，可选）：项目的名称（使用模糊匹配）project_id（字符串，可选）：项目的唯一标识符
返回值：
{
"project_id": "project_id_1",
"project_title": "My First Project",
"asset_count": 150,
"status": "success"
}示例用法：
# Using project name (recommended)
count_project_assets(project_name="Image Labeling")
# Using project ID
count_project_assets(project_id="abc123")配置
API密钥设置
此服务器支持多种方式来配置您的Kili API密钥：
选项1：环境变量（自动）
export KILI_API_KEY="your_actual_api_key"选项2：交互式配置（推荐给客户）
使用 configure_api_key 服务器启动后的工具：
- 启动服务器：
python server.py - 电话：
configure_api_key("your_actual_api_key") - 正常使用其他工具
选项3：Shell配置文件（持久性）
将导出命令添加到您的shell配置文件中：
# For bash users (~/.bashrc or ~/.bash_profile)
echo 'export KILI_API_KEY="your_actual_api_key"' >> ~/.bashrc
source ~/.bashrc
# For zsh users (~/.zshrc)
echo 'export KILI_API_KEY="your_actual_api_key"' >> ~/.zshrc
source ~/.zshrc如需更多身份验证选项，请参阅 Kili API文档.
项目结构
MCP_kili/
├── server.py # Main MCP server implementation
├── requirements.txt # Python dependencies
└── README.md # This file依赖项
- fastmcp（这个词汇本身在中文中没有直接对应的翻译，但可以解释为“快速多通道处理”或根据上下文具体含义进行翻译，这里提供一个通用的解释） - 快速MCP服务器框架
- kili - Kili Technology Python SDK（可译为：“Kili科技Python软件开发工具包”）
- RapidFuzz（快速模糊匹配库） - 项目名称搜索的快速模糊字符串匹配
参考文献
未来的改进/增强
可能要添加的功能：
- 导出项目数据
- 获取项目分析报告
- 列出项目成员
- 按元数据筛选资产
- 创建新项目
- 更新项目设置
许可证
这个项目仅用于演示目的。