AI助手数据交互服务

Jazz MCP Server是一个模型上下文协议服务器,使AI助手能够与基于Jazz框架构建的本地优先应用程序进行数据交互,包括创建、读取、更新和删除数据,以及同步设备间的数据。

  • by bensleveritt
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 bensleveritt/jazz-mcp-server

使用说明

Jazz MCP服务器

模型上下文协议(MCP)服务器,使AI助手能够与使用 Jazz框架.

这是什么?

Jazz MCP服务器允许Claude、ChatGPT等AI助手:

  • 在Jazz应用程序中创建、读取、更新和删除数据
  • 使用Jazz的分布式状态功能在设备之间同步数据
  • 管理身份验证和用户配置文件
  • 使用Jazz支持的富文本、媒体和其他数据类型

先决条件

  • Node.js 22.x或更高版本
  • npm或pnpm
  • 用于连接(或创建)的Jazz应用程序 npx create-jazz-app@latest)

安装

  1. 克隆此存储库:

    git clone https://github.com/bensleveritt/jazz-mcp-server.git
    cd jazz-mcp-server
    
  2. 安装依赖项:

    npm install
    # or with pnpm
    pnpm install
    
  3. 复制环境示例文件并根据需要进行配置:

    cp .env.example .env
    
  4. 构建服务器:

    npm run build
    # or with pnpm
    pnpm build
    

用法

启动MCP服务器:

npm start
# or with pnpm
pnpm start

对于自动重启的开发:

npm run dev
# or with pnpm
pnpm dev

连接AI助手

服务器在上公开MCP-兼容的API http://localhost:3000 (或您配置的主机/端口)。

在光标中

  1. 在Cursor中打开项目
  2. 点击光标AI设置
  3. 使用URL添加自定义MCP服务器 http://localhost:3000
  4. 使用在中配置的API密钥 .env 文件(如果启用了身份验证)

其他AI助手

按照AI助手的相关文档,通过URL连接到MCP服务器 http://localhost:3000.

可用工具

此MCP服务器为AI助手提供以下工具:

  • jazz.listApps -列出可用的Jazz应用程序
  • jazz.getAppData -从Jazz应用程序获取数据
  • jazz.updateAppData -更新Jazz应用程序中的数据
  • jazz.createAppData -在Jazz应用程序中创建新数据
  • jazz.deleteAppData -从Jazz应用程序中删除数据
  • jazz.auth.createUser -创建新用户
  • jazz.auth.login -登录现有用户

发展

服务器使用TypeScript构建,并使用官方的MCP协议实现。

关键文件:

  • src/index.ts -主要入口点
  • src/config.ts -配置加载
  • src/server.ts -MCP服务器实现
  • src/tools/ -单个工具实现
  • src/jazz/ -Jazz集成

许可证

麻省理工学院