使用说明
Hypergraph MCP服务器
一个全面的模型上下文协议（MCP）服务器，为使用Hypergraph框架构建应用程序提供智能协助。该服务器提供专门的工具，用于创建具有端到端加密和无缝数据同步的本地优先应用程序。
特性
Hypergraph MCP服务器包括10个按功能组织的专用工具：
核心工具
- 空间管理 -创建和管理带有邀请的公共/私人空间
- 架构定义 -生成具有验证和关系的实体模式
- 查询生成 -使用过滤器构建私有和公共数据的查询
- 认证 -设置地理连接和自定义身份验证提供程序
高级工具
- 知识图谱映射 -配置Schema.org属性映射
- 发布工作流 -实现数据发布到公共知识图谱
- React提供者 -生成上下文提供程序和自定义挂钩
- 文档 -访问综合指南和API参考资料
开发工具
- 快速入门模板 -React、Next.js和TypeScript的完整项目模板
- 高级配置 -本地服务器、性能优化、企业部署
安装
先决条件
- Node.js 18或更高版本
- npm或yarn包管理器
构建MCP服务器
- 克隆或导航到超图mcp服务器目录
- 安装依赖项：
npm install - 构建服务器：
npm run build
与Claude Code集成
安装
-
安装Claude Code命令行界面：
npm install -g @anthropic/claude-code -
配置MCP服务器： 将以下内容添加到您的Claude Code配置文件中(
~/.claude-code/mcp.json):{ "mcpServers": { "hypergraph": { "command": "node", "args": ["/path/to/hypergraph-mcp-server/dist/index.js"], "env": {} } } } -
启动克劳德代码：
claude-code
Claude代码中的用法
连接后，您可以使用以下工具：
# Generate a new Hypergraph space
/mcp hypergraph generate_space
# Create entity schema
/mcp hypergraph create_schema
# Generate queries
/mcp hypergraph create_query
# Setup authentication
/mcp hypergraph setup_auth
# Get documentation
/mcp hypergraph get_documentation
# Create quickstart project
/mcp hypergraph generate_quickstart
# And more...
与Cursor集成
安装
-
安装游标 从 cursor.sh
-
将MCP服务器添加到游标：
- 打开光标设置
- 导航到“扩展”� "MCP"
- 添加新的服务器配置：
{ "name": "hypergraph", "command": "node", "args": ["/path/to/hypergraph-mcp-server/dist/index.js"] }
-
启用服务器：
- 将Hypergraph MCP服务器切换为“启用”
- 重新启动游标
游标中的用法
在Cursor中，您可以通过MCP面板或使用 @hypergraph 提示中的前缀：
@hypergraph help me create a new space for my project
@hypergraph generate a schema for user profiles
@hypergraph show me how to implement authentication
可用工具
1.空间管理(generate_space)
使用适当的访问控制创建和配置Hypergraph空间。
参数：
spaceName：空间名称spaceType：公共、私人或仅限邀请framework：react、typescript或vanilla js
2.模式定义(create_schema)
生成具有验证和关系的实体模式。
参数：
entityName：实体名称fields：字段定义数组relationships：实体关系includeValidation：添加验证规则
3.查询生成(create_query)
通过过滤和分页构建数据检索查询。
参数：
entityType：目标实体类型queryType：全部、筛选或分页filters：查询筛选器framework：实施框架
4.身份验证设置(setup_auth)
配置身份验证提供程序和用户管理。
参数：
authProvider：地理连接或自定义includeRegistration：包括用户注册framework：实施框架
5.知识图谱映射(create_mapping)
将私有模式映射到公共知识图属性。
参数：
entityType：要映射的实体schemaOrg：使用Schema.org映射customMappings：自定义属性映射
6.发布工作流程(create_publishing_flow)
实现数据发布到公共知识图谱。
参数：
entityType：要发布的实体类型publishingStrategy：立即、批量、计划或有条件includeValidation：发布前添加验证
7.反应提供者(setup_providers)
生成React上下文提供程序和自定义钩子。
参数：
providerType：应用程序、空间或两者兼而有之includeAuth：包括身份验证提供程序includeCustomHooks：生成自定义挂钩
8.文件(get_documentation)
访问全面的文档和示例。
参数：
topic：文档主题format：标记、文本或代码示例language：typescript、javascript、react或全部
9.快速入门模板(generate_quickstart)
生成带有示例的完整项目模板。
参数：
projectName：项目名称framework：react、nextjs、vanilla ts或express apientityTypes：要包括的实体类型includeAuth：包括身份验证设置
10.高级配置(advanced_setup)
配置本地服务器和性能优化等高级功能。
参数：
setupType：本地服务器、自定义身份验证、性能优化等。complexity：中级、高级或专家framework：node、docker、kubernetes或无服务器
知识库
该服务器由一个全面的知识库提供支持，该知识库包含从官方Hypergraph文档中抓取的56个页面，包括：
- 核心概念和架构
- 认证与安全
- 数据建模和模式
- 查询模式和优化
- 发布工作流程
- React集成模式
- 性能最佳实践
- 故障排除指南
发展
项目结构
hypergraph-mcp-server/
�� src/
�� index.ts # Main server implementation
�� tools/ # Tool implementations
�� spaces.ts # Space management
�� schema.ts # Schema definition
�� queries.ts # Query generation
�� auth.ts # Authentication
�� mapping.ts # Knowledge Graph mapping
�� publishing.ts # Publishing workflows
�� providers.ts # React providers
�� docs.ts # Documentation
�� quickstart.ts # Quickstart templates
�� advanced.ts # Advanced configurations
�� knowledge/ # Knowledge base
�� hypergraph_knowledge_base.md
�� hypergraph_data.json
�� package.json
�� tsconfig.json
�� README.md
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
支持
关于以下问题：
- Hypergraph框架：参观 超图形开发
- MCP服务器：在此存储库中创建问题
- 克劳德代码：参观 Claude代码文档
- 光标：参观 光标文档
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
