家族树MCP演示

该项目提供了一个用于探索和查询虚构家族树的模型上下文协议（MCP）服务器。它使用C#和.NET实现，并提供了检索、添加和更新家庭成员及其关系的工具。

特性

• 列出家族树中的所有人
• 根据ID查询单个家庭成员
• 分析关系（父母、子女、配偶）
• 可轻松扩展新工具

项目结构

• family_tree_mcp_demo/
  • family_webapi/ -- 一个超级简单的Web服务，返回JSON数据
  • mcp_server/ -- 基于控制台（标准输入输出）的服务器，可与VSCode/Claude等MCP客户端一起使用。
  • mcp_client_meai/ -- 使用Microsoft.Extensions.AI的MCP客户端
  • mcp_client_sk/ -- 使用Semantic Kernel的MCP客户端
  • mcp_tests/ -- 服务和工具的单元测试
  • mcp_webapi/ -- 在MCP服务器中未使用，但在演示中有用。

当你使用VSCode作为客户端时，请创建一个.vscode/mcp.json MCP服务器配置文件。（也可以适应Claude。）

{
    "servers": {
        "my-mcp-server-abc123": {
            "type": "stdio",
            "command": "dotnet",
            "args": [
                "run",
                "--project",
                "<your_path>\\mcp_server\\mcp_server.csproj"
            ]
        }
    }
}

快速开始

先决条件

• .NET 9.0 SDK

运行MCP客户端

1. 克隆仓库：

   git clone https://github.com/AlfredBr/family_tree_mcp_demo.git
   

2. 运行提供JSON数据的Web服务器：

   dotnet run --project family_tree_mcp_demo/family_webapi/family_webapi.csproj
   

3. 运行基于__Semantic Kernel__的客户端：

   dotnet run --project family_tree_mcp_demo/mcp_client_sk/mcp_client_sk.csproj
   

   或者运行基于__Microsoft.Extensions.AI__的客户端：

   dotnet run --project family_tree_mcp_demo/mcp_client_meai/mcp_client_meai.csproj
   

4. 或者你可以只运行服务器并使用VSCode作为客户端：

   在VSCode中打开'mcp.json'并选择'Start'以启动MCP服务器
   

   服务器将根据.vscode/mcp.json中的配置启动并监听MCP请求。

测试

运行所有测试：

cd mcp_tests
dotnet test

示例问题

这里有一些你可以向这个MCP服务器提问的例子：

• 列出家族树中的所有人。
• 艾丽莎·卡特的父母是谁？
• 玛格丽特·卡特的所有孩子的名字是什么？
• 列出家族树中的所有姓氏。
• 家族中最年轻的男性是谁？
• 琳达·卡特生孩子时多大？
• 获取ID为p5的人的详细信息。
• 苏珊·史密斯的配偶是谁？
• 列出1980年后出生的所有人。
• 艾米莉·史密斯和威廉·卡特之间的关系是什么？

许可证

MIT许可证

---

此项目旨在演示和教育用途。