AIquila MCP 服务器

关键词

云端上下文服务Nextcloud 集成工具注册与执行医疗/生产力协同Claude 集成

使用说明

  • 项目简介
    • AIquila MCP 服务器是一套完整的 MCP 服务器实现，提供资源管理、工具注册/执行、以及基于模板的 Prompt 渲染能力，面向 LLM 客户端（如 Claude 的桌面/手机客户端）提供统一的上下文服务。
    • 服务器实现基于 Node.js/TypeScript 的 MCP 服务端框架，含两种传输适配：stdio（面向桌面客户端）与 http（面向容器化/云端部署）。同时提供多组工具集，覆盖文件、日历、笔记、用户/组/应用等 Nextcloud 相关操作，以及与 Claude 集成的自定义应用。
  • 主要功能点
    • MCP 核心实现：注册、暴露和执行工具集合，按工具名、描述、输入模式对外提供标准化接口。
    • 资源、工具与提示模板管理：内置多种 Tools（如 list_files、read_file、calendar、notes、cookbook、maps 等）以及应用内的操作工具，并可通过 MCP 请求调用。
    • 提供两种传输：stdio（Claude 桌面端等本地客户端的直接 I/O）与 http（基于 JSON-RPC 的可流式传输，支持云端/容器化部署）。
    • 会话管理与鉴权：通过可选的 OAuth 认证流程（在 HTTP 传输中实现 bearer token / OAuth 路由）、以及日志审计。
    • 模板与渲染：嵌入式 Prompt/模板体系，支持对接 Claude 的上下文渲染。
  • 安装步骤
    • 需要 Node.js 环境与 TypeScript 构建工具。通常流程如下：
      1. 克隆仓库并安装依赖（npm install）。
      2. 构建 MCP 服务器（通常通过 npm/yarn 构建产物）。
      3. 启动两种传输之一：
        • 通过_stdio_启动以便 Claude 桌面端直连（stdio 模式）。
        • 通过_http_启动以对外提供 HTTP API（如 Traefik/Nginx 反向代理后端）。
      4. 根据部署环境选择配置环境变量（如 MCP_TRANSPORT、MCP_PORT、MCP_AUTH_ENABLED、NEXTCLOUD_URL、HETZNER 等等的相关变量）。
    • 运行前提与依赖
      • Nextcloud 服务端地址与凭证（用于跨组件交互的示例工具）。
      • 可选的 OAuth 提供者配置（HTTP 传输时需要）。
  • 服务器配置（MCP 客户端连接信息示例说明） 说明：以下为 MCP 客户端配置信息示例（以 JSON 表达，实际项目中客户端可能以不同格式读取，请仅用于理解参数含义，不构成可直接执行的代码）。
    • serverName: aiquila
    • startCommand: node
    • args: ["path/to/your/mcp-server/dist/index.js"]
    • transport: stdio 或 http 注释说明：
    • serverName 用于标识 MCP 服务器在客户端的连接目标。
    • startCommand 与 args 指定启动服务器的命令及参数（示意性描述，实际部署需按你们的构建产物路径配置）。
    • transport 指定客户端如何与服务器通信，stdio 适合桌面端场景，http 适合容器化、云环境。
    • 其他字段（如认证、超时、缓存等）按客户端实现自行扩展。
  • 基本使用方法
    • 启动后端：运行服务器进程，确保网络/证书配置正确，若走 HTTP，确保 TLS/证书配置就绪。
    • 客户端接入：在 Claude/LLM 客户端中按以上后的连接信息提供的服务器名称、启动命令与参数进行连接，若使用 HTTP 传输，请确保 Bearer Token/OAuth 设置与 MCP_AUTH_ENABLED 配置匹配。
    • 常用操作：通过 MCP 提供的工具集合，与 Nextcloud 的数据/应用进行交互（如读取/写入文件、创建日历事件、管理应用、查询导航数据等）。

服务器信息

访问项目