项目简介

Jility是一个为人类和AI代理协同工作设计的AI原生项目管理工具。Jility MCP服务器是其后端组件之一,专门用于以标准化的方式向大型语言模型(LLM)客户端提供项目管理上下文信息和执行项目管理功能。它将Jility的核心项目管理功能(如创建/更新任务、获取任务详情、协作等)封装为可供LLM调用的工具。

主要功能点

  • 任务管理: AI代理可以创建新任务、批量创建任务、获取任务详情、更新任务状态、编辑任务描述、认领未分配任务。
  • 协作功能: AI代理可以为任务添加评论、分配或重新分配任务给其他成员(包括其他AI代理)。
  • 项目追踪: 支持链接Git提交到任务,以及管理任务间的依赖关系。
  • 查询与搜索: AI代理可以根据各种条件筛选和搜索任务,以获取相关上下文。
  • 协议支持: 通过标准输入/输出(Stdio)传输协议与LLM客户端进行JSON-RPC通信。

安装步骤

  1. 前提条件: 确保您的系统已安装Rust(最新稳定版)。
  2. 构建Jility CLI (包含MCP服务器): 首先,从GitHub克隆Jility仓库并构建。这将生成包含MCP服务器功能的 'jility' 可执行文件。
    git clone https://github.com/zachswift615/Jility.git
    cd Jility
    cargo build --release --workspace
    # MCP服务器的二进制文件将位于 ./target/release/jility
    # (可选)您可以将此文件添加到系统的PATH中,例如:
    # cp ./target/release/jility /usr/local/bin/jility
  3. 启动Jility后端API服务器(必需): Jility MCP服务器需要与Jility的REST API后端通信以执行实际的项目管理操作。请确保Jility后端API服务器已运行,默认地址是 'http://localhost:3900'。 您可以回到Jility仓库的根目录,使用提供的开发脚本启动后端:
    # 在Jility仓库根目录运行,这将同时启动Rust后端和Next.js前端
    ./dev.sh start
    # 或者,如果您只想手动启动后端,可以进入jility-server目录运行:
    # cd jility-server
    # cargo run

服务器配置 (供MCP客户端使用)

MCP客户端需要以下JSON格式的配置来启动和连接Jility MCP服务器:

{
  "server_name": "Jility MCP Server",
  "command": "jility",
  "args": ["--mcp-server"],
  "environment": {
    "JILITY_API_URL": "http://localhost:3900/api", // 请替换为您的Jility后端API服务器的实际地址
    "JILITY_API_TOKEN": "your_api_key_or_jwt_token" // 可选。如果您的Jility后端API需要认证,请在此处填写您的Jility API密钥或JWT令牌。
  },
  "transport": "stdio", // Jility MCP服务器通过标准输入/输出进行通信
  "capabilities": {
    "tools": {
      "list_changed": false
    }
  },
  "description": "AI-native project management capabilities for LLM agents through the Jility MCP server."
}

基本使用方法

MCP服务器通常由兼容的LLM客户端(如Anthropic Claude)自动启动和调用。LLM代理会通过标准输入/输出来发送JSON-RPC请求,调用服务器提供的工具。

例如,一个LLM代理可能会调用 'create_ticket' 工具来创建一个新任务,或者调用 'get_ticket' 来获取任务的详细信息。

您无需直接与此服务器交互,它是一个后台服务,旨在被AI代理程序化调用。

信息

分类

开发者工具