Mcpchatbot Project Test

Neo4j MCP 项目

一个模型上下文协议（MCP）服务器，为人工智能代理提供工具，以便与包含《权力的游戏》角色和关系数据的Neo4j数据库进行交互。

🚀 项目结构

neo4j-mcp-project/
├── mcp-server/          # MCP Server with Neo4j integration
├── frontend/            # React frontend application
├── graph_data/          # Neo4j database and Game of Thrones data
└── README.md            # This file

🛠️ MCP 工具可用

服务器为AI代理提供了以下MCP工具：

数据检索工具

• get_characters - 检索角色，可选择性地应用房屋过滤器
• get_relationships - 获取角色之间的关系
• search_characters - 按名称搜索角色
• get_database_stats - 获取数据库统计信息

数据修改工具

• create_character - 将新字符添加到数据库中
• create_relationship - 建立角色之间的关系
• update_character - 修改角色信息
• delete_character - 删除角色及其关系

🔧 开始使用

先决条件

• Node.js（v16或更高版本）
• 运行在7474端口上的Neo4j数据库

安装

1. 启动MCP服务器：

   cd mcp-server
   npm install
   npm start

1. 启动前端：

   cd frontend
   npm install
   npm run dev

MCP 终点（或：MCP 端点）

• 工具发现： GET /api/mcp/tools
• 工具执行： POST /api/mcp/execute
• AI执行： POST /api/ai-execute

示例用法

发现可用工具：

curl http://localhost:3001/api/mcp/tools

执行一个工具：

curl -X POST http://localhost:3001/api/mcp/execute \
  -H "Content-Type: application/json" \
  -d '{"tool_name": "get_characters", "parameters": {"limit": 10}}'

基于人工智能的自然语言：

curl -X POST http://localhost:3001/api/ai-execute \
  -d '{"prompt": "Show me all characters in House Stark"}'

🌐 接入点

• MCP 服务器： http://localhost:3001 翻译为中文是：“本地主机：3001 端口”。不过，通常我们不会直接翻译网址的格式，而是说明其含义或用途，比如“访问本地开发服务器的3001端口”。但在这里，按照您的要求，直接翻译网址的格式部分就是“本地主机：3001 端口”
• 前端： http://localhost:5173 翻译为中文可以是：“本地主机的5173端口”。不过，通常我们不会直接翻译网址，而是理解为在本地计算机上运行的一个服务或应用，可以通过该端口访问。所以，也可以理解为“访问本地计算机上的5173端口服务”。但简短来说，“http://localhost:5173”就表示在本地计算机上通过5173端口访问某个服务或应用
• Neo4j 浏览器： http://localhost:7474 翻译为中文是：“本地主机上的7474端口”

📊 数据

该数据库包含了《权力的游戏》全部8季的数据：

• 角色： 126+ 位带有家族隶属关系的角色
• 人际关系： 549+个角色间的互动
• 季节： 第1-8季的数据

🔍 MCP规范符合性

此服务器实现了模型上下文协议规范：

• 工具发现： AI代理可以发现可用的功能
• 结构化模式（或架构）： 对所有工具进行JSON Schema验证
• 类型安全性： 输入/输出参数的强类型检查
• 错误处理： 全面的错误处理和反馈

🤖 人工智能集成

该服务器包含一个AI执行端点，其功能为：

• 利用OpenAI来理解自然语言请求
• 自动选择合适的MCP工具
• 在AI不可用时提供智能回退方案
• 返回包含执行细节的结构化结果

📝 许可证

ISC许可证