llmkit MCP 服务器

关键词

模型上下文协议工具调用JSON-RPC预算与使用查询服务器健康

使用说明（Markdown 格式）

项目简介

  • llmkit 的 MCP 服务器是一套实现 MCP 协议核心能力的后端服务。它定义并注册了一组工具，以便 MCP 客户端（如 Claude Code、Cursor）可以通过统一的 JSON-RPC 接口调用这些工具，获取统计、预算状态、会话摘要等信息。

主要功能点

  • MCP 初始化与工具注册：支持 initialize、tools/list、tools/call 等基本 MCP 流程，提供工具清单及调用入口。
  • 工具实现与查询：包含 llmkit_usage_stats、llmkit_cost_query、llmkit_budget_status、llmkit_session_summary、llmkit_list_keys、llmkit_health 等工具，能够对账户、预算、会话、请求日志等进行查询。
  • 认证与安全：通过 API key 机制进行鉴权，保障只有授权用户能够访问 MCP 服务的功能。
  • MCP 传输与路由：实现了基于 MCP 的 JSON-RPC 请求路由，具备可扩展性，支持集成到不同环境（CLI、云端网关等）。
  • 与外部系统的对接点：提供对 Supabase 的只读/写入能力，用于查询 API keys、请求记录、预算等数据，具备基本的异常处理与日志记录。
  • 自研工具生态：通过工具/路由的结构，便于未来扩展更多自定义工具。

安装步骤（本地开发环境）

  • 安装并构建：
    • 安装依赖并构建整个仓库（推荐在根目录执行）：pnpm install && pnpm build
  • 启动 MCP 服务器（在本地开发环境中）
    • 进入 packages/mcp-server，使用仓库提供的入口启动方式（该包提供一个可执行入口用于启动 MCP 服务器，984 行的实现通过标准输入/输出读取 JSON-RPC 请求并返回响应）。
  • 部署注意
    • MCP 服务器需要接入一个客户端来进行认证（通过 API Key 查询用户），并可结合 Durable Objects 实现预算/会话等状态管理。

服务器配置（MCP 客户端需要的最小配置信息）

  • MCP 服务器在客户端配置中需要提供服务器的启动命令与参数，示例配置（JSON，供 MCP 客户端使用）如下： { "mcpServers": { "llmkit": { "command": "npx", "args": ["@f3d1/llmkit-mcp-server"] } // 如有需要，可以添加更多服务器条目 } } 说明
  • command：启动 MCP 服务器的命令。此处示例使用 npx 调用 llmkit-mcp-server 包的入口。
  • args：启动参数数组，按需调整。
  • MCP 客户端配置示例中的服务器名称应与实际部署名称一致，便于后续的发现与调用。

基本使用方法

  • 客户端调用流程通常包含：
    • 初始化：向 MCP 服务器发起 initialize 请求，获取服务器能力信息。
    • 列出工具：通过 tools/list 获取可用工具清单。
    • 调用工具：通过 tools/call 指定工具名和参数，获取工具执行结果。
  • 认证与安全性由 MCP 客户端在调用中携带授权信息（如 Bearer Key），服务端会进行鉴权并返回结果。
  • 通过上述工具，Claude Code/Cursor 等可以查询使用情况、成本、预算状态、会话摘要等数据，帮助实现对话上下文的成本控制与分析。

额外信息

  • MCP Card 信息：llmkit 的 MCP 服务器公开了 server-card.json，用于发现能力与身份认证类型。
  • 本实现具备本地化的健壮性和错误处理，适合在自托管环境下直接部署执行。

关键词 模型上下文协议, 工具调用, JSON-RPC, 预算与使用查询, 服务器健康

分类ID 6

服务器信息

访问项目