图形云安装程序

Name: 图形云安装程序
Author: Niels-8

作者：Niels-82 星标更新：2025-11-07

安装使用来源：spider==github.com

项目介绍

Graphiti Cloud Installer

用于在云平台和自定义服务器上部署Graphiti（一种用于AI代理的时间知识图框架）的自动化安装脚本。

概述

Graphiti Cloud Installer 提供一键部署脚本，自动设置支持MCP（模型上下文协议）的Graphiti：

Google Cloud Platform (GCP)
Amazon Web Services (AWS)
Microsoft Azure
通过SSH连接的自定义服务器

安装程序处理所有依赖项，配置Docker容器，设置图形数据库（FalkorDB或Neo4j），并公开一个公共MCP端点，以便与AI客户端（如Claude Desktop、Cursor和VS Code）集成。

特性

🚀 多平台一键安装
🐳 基于Docker的部署，确保一致性和可移植性
🔄 选择图形数据库：FalkorDB（轻量级）或Neo4j（生产级）
🔐 HTTPS支持，自动生成SSL证书
🔑 多语言模型支持：OpenAI、Anthropic、Google Gemini、Groq
🔁 幂等脚本，重新运行以更新是安全的
📊 内置健康检查和验证
🌐 公共MCP端点，用于AI客户端集成

快速开始：MCP客户端配置

在您的云服务器上安装Graphiti后，您需要配置您的AI客户端以连接到MCP端点。

🔒 重要提示：HTTP vs HTTPS

默认情况下，您的Graphiti服务器使用HTTP（而不是HTTPS）：

默认URL：http://YOUR_SERVER_IP:8000/mcp
HTTPS是可选的，需要自定义域名

要启用HTTPS：

拥有一个域名（例如，graphiti.yourdomain.com）
将域名指向您的服务器IP（DNS A记录）
在安装过程中输入域名
脚本会自动配置Let's Encrypt SSL

安全性考虑：

✅ HTTP适用于：测试、开发、私有网络
⚠️ 推荐HTTPS用于：生产环境、公共访问、敏感数据

💡 提示：对于大多数用例，基于IP的HTTP就足够了。您可以在稍后通过重新运行安装并提供一个域名来添加HTTPS。

📱 客户端配置

以下是流行AI客户端的确切配置。除非您在安装时配置了一个域名，否则使用HTTP URL。

🤖 Claude Desktop

配置文件位置：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json
Linux：~/.config/Claude/claude_desktop_config.json

配置格式（HTTP - 默认）：

{
  "mcpServers": {
    "graphiti": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://YOUR_SERVER_IP:8000/mcp/",
        "--allow-http"
      ]
    }
  }
}

对于HTTPS（如果您配置了一个域名）：

{
  "mcpServers": {
    "graphiti": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-domain.com/mcp/"
      ]
    }
  }
}

📝 替换 YOUR_SERVER_IP 为安装结束时显示的IP地址（例如，34.123.45.67）

⚠️ 重要：HTTP连接需要--allow-http标志。使用HTTPS时移除它。

💡 什么是mcp-remote？ 它是一个桥接工具，转换于Claude Desktop使用的stdio协议和Graphiti服务器使用的HTTP/SSE协议之间。

💻 Cursor IDE

配置文件位置：

macOS：~/Library/Application Support/Cursor/User/settings.json
Windows：%APPDATA%\Cursor\User\settings.json
Linux：~/.config/Cursor/User/settings.json

配置格式：

{
  "mcp.servers": {
    "graphiti": {
      "url": "http://YOUR_SERVER_IP:8000",
      "name": "Graphiti 知识图谱",
      "enabled": true
    }
  }
}

如何配置：

打开Cursor设置（Cmd/Ctrl + ,）
点击右上角的“打开设置（JSON）”
添加mcp.servers配置
保存并重新加载Cursor

🔷 VS Code（带GitHub Copilot）

配置文件位置：

macOS：~/Library/Application Support/Code/User/settings.json
Windows：%APPDATA%\Code\User\settings.json
Linux：~/.config/Code/User/settings.json

配置格式：

{
  "github.copilot.advanced": {
    "mcp": {
      "enabled": true,
      "servers": {
        "graphiti": {
          "url": "http://YOUR_SERVER_IP:8000",
          "description": "Graphiti 时间知识图谱"
        }
      }
    }
  }
}

如何配置：

打开VS Code设置（Cmd/Ctrl + ,）
点击右上角的“打开设置（JSON）”图标
添加上述配置
重新加载VS Code（Cmd/Ctrl + Shift + P → “重新加载窗口”）

🎯 Kiro IDE

配置文件位置：

macOS：~/.kiro/settings/mcp.json
Windows：%USERPROFILE%.kiro\settings\mcp.json
Linux：~/.kiro/settings/mcp.json

配置格式：

{
  "mcpServers": {
    "graphiti": {
      "command": "node",
      "args": [
        "/path/to/mcp-client.js",
        "http://YOUR_SERVER_IP:8000"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

替代方案：直接HTTP连接：

{
  "mcpServers": {
    "graphiti": {
      "url": "http://YOUR_SERVER_IP:8000/mcp",
      "transport": "http",
      "disabled": false
    }
  }
}

如何配置：

打开命令面板（Cmd/Ctrl + Shift + P）
搜索“MCP: 打开配置”
添加Graphiti服务器配置
配置更改后服务器会自动重新连接

🌐 OpenAI API / 自定义客户端

对于自定义集成或基于OpenAI API的客户端：

HTTP端点：

http://YOUR_SERVER_IP:8000/mcp

健康检查：

curl http://YOUR_SERVER_IP:8000/health

示例cURL请求：

curl -X POST http://YOUR_SERVER_IP:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 
  }'

🔒 HTTPS配置（可选 - 需要域名）

只有在安装期间提供了域名时才可用HTTPS。

安装期间，您会看到此提示：

输入用于SSL的域名（留空以使用基于IP的访问）：

如果您留空 → 使用HTTP URL（上面的示例） 如果您输入了一个域名 → 使用HTTPS URL（下面的示例）

HTTPS配置示例：

{
  "mcpServers": {
    "graphiti": {
      "url": "https://your-domain.com/mcp",
      "transport": "http"
    }
  }
}

HTTPS要求：

✅ 拥有一个域名
✅ DNS A记录指向您的服务器IP
✅ 安装期间输入域名
✅ 防火墙中开放80和443端口

HTTPS会发生什么：

自动配置Let's Encrypt SSL证书
HTTP自动重定向到HTTPS
配置证书自动续订
安全加密连接

✅ 测试您的连接

配置后，测试连接：

检查健康端点：

# 对于HTTP（默认）
curl http://YOUR_SERVER_IP:8000/health

# 对于HTTPS（如果已配置域名）
curl https://your-domain.com/health

预期响应：{"status": "healthy"}

测试MCP端点：

# 对于HTTP（默认）
curl http://YOUR_SERVER_IP:8000/mcp

# 对于HTTPS（如果已配置域名）
curl https://your-domain.com/mcp

询问您的AI客户端：
- "你能检查一下Graphiti MCP服务器是否连接了吗？"
- "在我的知识图谱中添加一个关于学习Python的事件"
- "你知道我的偏好是什么吗？"

💡 注意：用实际的服务器IP地址替换YOUR_SERVER_IP（安装结束时提供），或者如果您配置了HTTPS，则使用您的域名。

🔧 故障排除MCP连接

连接被拒绝：

验证服务器IP地址是否正确
检查防火墙是否允许端口80、443、8000
确保Docker容器正在运行：docker ps
使用HTTP，而不是HTTPS（除非您配置了一个域名）

"SSL/TLS错误"或"证书错误"：

❌ 您使用的是https://但没有配置域名
✅ 解决方案：使用http://YOUR_SERVER_IP:8000代替
HTTPS仅在您在安装期间提供了域名时才有效

身份验证错误：

验证您的LLM API密钥是否已在服务器的.env文件中配置
检查服务器日志：docker logs graphiti-mcp

MCP未出现在客户端中：

配置后重启您的AI客户端
检查配置文件语法（有效的JSON）
查看客户端控制台/日志中的错误

"我如何以后添加HTTPS？"

您需要重新运行安装脚本
当提示时提供一个域名
确保DNS指向您的服务器IP
或者手动配置Let's Encrypt（高级）

先决条件

通用要求

所有安装都需要：

操作系统：Linux（Ubuntu 20.04+，Debian 10+，CentOS 7+）或macOS
Bash：版本4.0或更高
互联网连接：用于下载Docker镜像和依赖项
至少一个LLM API密钥：参见下文的API密钥要求

平台特定要求

Google Cloud Platform (GCP)

gcloud CLI：安装指南
GCP账户：具有启用计费功能
权限：启用Compute Engine API，创建实例和防火墙规则的权限
推荐实例：e2-micro（共享vCPU，1GB内存，约$6/月）用于FalkorDB，e2-medium（共享vCPU，4GB内存，约$24/月）用于Neo4j

验证gcloud安装：

gcloud --version

Amazon Web Services (AWS)

aws CLI：安装指南
AWS账户：具有活动凭证
权限：EC2完全访问，VPC管理权限
推荐实例：t3.micro（2个vCPU，1GB内存，约$7.50/月）用于FalkorDB，t3.medium（2个vCPU，4GB内存，约$30/月）用于Neo4j

验证aws CLI安装：

aws --version

Microsoft Azure

az CLI：安装指南
Azure账户：具有活动订阅
权限：虚拟机贡献者角色或更高
推荐VM：Standard_B1s（1个vCPU，1GB内存，约$7.50/月）用于FalkorDB，Standard_B2s（2个vCPU，4GB内存，约$30/月）用于Neo4j

验证az CLI安装：

az --version

自定义服务器（SSH）

SSH客户端：大多数Linux/macOS系统预装
服务器要求：
- Ubuntu 20.04+或Debian 10+（推荐）
- 最少1个vCPU，1GB内存用于FalkorDB；2个vCPU，4GB内存用于Neo4j
- 20GB可用磁盘空间
- 端口80、443、8000可访问
- root或sudo访问
SSH访问：密码或SSH密钥认证

验证SSH客户端：

ssh -V

API密钥要求

您需要来自以下LLM提供商的至少一个API密钥：

OpenAI

注册：https://platform.openai.com/signup
获取API密钥：https://platform.openai.com/api-keys
定价：按需付费，起价$0.0015/1K令牌

Anthropic（Claude）

注册：https://console.anthropic.com/
获取API密钥：控制台 → 设置 → API密钥
定价：按需付费，起价$0.25/1M令牌

Google Gemini

注册：https://makersuite.google.com/
获取API密钥：https://makersuite.google.com/app/apikey
定价：免费层级可用，然后按需付费

Groq

注册：https://console.groq.com/
获取API密钥：控制台 → API密钥
定价：免费层级可用，带有速率限制

API密钥的最佳安全实践：

绝不公开分享您的API密钥
绝不在版本控制中提交API密钥
定期轮换密钥
使用环境变量存储
监控使用情况以检测未经授权的访问
在提供商仪表板上设置支出限额

安装

步骤说明：Google Cloud Platform (GCP)

克隆仓库

git clone https://github.com/Niels-8/graphiti-cloud-installer.git
cd graphiti-cloud-installer

确保gcloud CLI已认证

gcloud auth login
gcloud config set project YOUR_PROJECT_ID

运行安装脚本

chmod +x install-gcp.sh
./install-gcp.sh

跟随交互式提示
- GCP项目ID：输入您的GCP项目ID（例如，my-project-123）
- 区域：选择一个区域（例如，us-central1，europe-west1）
- 实例类型：按Enter键使用默认值（e2-micro以优化成本）或指定自定义
- 数据库类型：选择falkordb（默认）或neo4j
- API密钥：输入至少一个LLM提供商API密钥
- 域名（可选）：输入一个域名用于SSL或按Enter键跳过
等待安装完成（通常5-10分钟）
- 脚本创建一个Compute Engine实例
- 配置防火墙规则（端口80、443、8000）
- 安装Docker和Docker Compose
- 部署Graphiti和数据库容器
- 运行健康检查

保存您的MCP端点URL

✓ 安装完成！
MCP端点：https://34.123.45.67/mcp/
健康检查：https://34.123.45.67/health

配置您的AI客户端（参见MCP客户端配置）

步骤说明：Amazon Web Services (AWS)

克隆仓库

git clone https://github.com/your-repo/graphiti-cloud-installer.git
cd graphiti-cloud-installer

确保AWS CLI已配置

aws configure
# 输入您的AWS访问密钥ID、秘密访问密钥和默认区域

运行安装脚本

chmod +x install-aws.sh
./install-aws.sh

跟随交互式提示
- AWS区域：选择一个区域（例如，us-east-1，eu-west-1）
- 实例类型：按Enter键使用默认值（t3.micro以优化成本）或指定自定义
- 密钥对：选择现有密钥对或创建新的
- 数据库类型：选择falkordb（默认）或neo4j
- API密钥：输入至少一个LLM提供商API密钥
- 域名（可选）：输入一个域名用于SSL或按Enter键跳过