tic MCP 服务器

使用说明内容（Markdown格式）

• 项目简介
  • tic 是一个在本地实现的 MCP（Model Context Protocol）服务器端应用，旨在通过标准化的 JSON-RPC 请求响应向大语言模型提供工作项的上下文与功能，包括资源（Items/模板等）的管理、工具执行以及提示模板的渲染等能力，并通过标准传输（如 stdio）与客户端通信。
• 主要功能点
  • MCP 服务器核心能力：实现 MCP 的服务端逻辑，按 JSON-RPC 规格处理请求并返回响应，管理会话与能力声明。
  • 资源与数据能力：暴露并管理工作项、模板等资源，提供读取、创建、更新、删除等数据访问能力。
  • 工具注册与执行：注册可由 LLM 调用的工具（如列出、读取、更新工作项等），支持参数传递与结果返回。
  • Prompt 模板与渲染：定义并渲染提示模板及其字段，便于 LLM 端在对话中获取上下文信息。
  • 多后端集成：内置多种后端实现（本地、GitHub、GitLab、Azure DevOps、Jira），自动检测或手动切换后端，以适配不同的数据源。
  • 开放传输与扩展性：通过 JSON-RPC 与客户端通信，支持未来扩展的传输层（如 SSE、WebSocket 等）。
  • 与 Tic CLI 的集成：通过 tic mcp serve 启动服务，CLI 内部可将 MCP 服务器作为后端对接到 LLM 客户端。
• 安装步骤
  • 安装 Node.js 环境（推荐使用最新稳定版本）。
  • 将项目源码获取到本地环境，并安装依赖（如 npm install）。
  • 全局安装或本地运行 Tic CLI，然后通过下述命令启动 MCP 服务器：
    • 使用 Tic CLI 启动 MCP 服务器：tic mcp serve
• 服务器配置（面向 MCP 客户端，通过 JSON 配置描述服务器启动方式）
  • 服务器名称（server）：tic
  • 启动命令（command）：tic
  • 参数（args）：[ "mcp", "serve" ] 配置说明：该配置让 MCP 客户端通过创建一个外部进程来启动 Tic 提供的 MCP 服务器，并通过标准输入输出（stdio）进行 JSON-RPC 的请求和响应传输。客户端本身无需了解具体实现细节，只需要知道服务器名称、启动命令及所需参数即可建立连接。
• 基本使用方法
  • 启动服务器后，客户端通过 JSON-RPC 发送请求以读取资源、执行工具、获取提示模板等。
  • 客户端可以读取服务器暴露的能力声明，决定可用的操作集合。
  • 可以通过 Tic 的命令行界面或集成到你现有的 LLM 工作流中，将 MCP 服务器嵌入到对话系统中，提供实时的上下文和功能支持。
• 运行与调试提示
  • 确保后端实现的各类后端（本地、GitHub、GitLab、AzureDevOps、Jira）所需的依赖组件已正确配置（如本地存储、远程接口、认证等）。
  • 启动时若遇到权限或认证错误，请先完成对应后端的认证流程。
  • MCP 服务的传输模式默认使用 stdio，后续版本可扩展为 SSE/WebSocket 等传输层。