family tree MCP demo server

家谱MCP演示

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

特性

• 在家谱中列出所有人
• 按ID查询单个家庭成员
• 分析关系（父母、子女、配偶）
• 使用新工具可轻松扩展

项目结构

• family_tree_mcp_demo/

- family_webapi/ --一个返回JSON数据的超简单Web服务 - mcp_server/ --基于控制台的（stdio）服务器，与VSCode/Claude等MCP客户端一起使用。 - mcp_client_meai/ --使用微软的MCP客户端。扩展。人工智能 - mcp_client_sk/ --使用语义内核的MCP客户端 - mcp_tests/ --服务和工具的单元测试 - mcp_webapi/ --未在MCP服务器中使用，但可用于演示。

创建一个 .vscode/mcp.json 使用VSCode作为客户端时的MCP服务器配置。（也可以改编成克劳德。）

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

入门指南

先决条件

• .NET 9.0 SDK

运行MCP客户端

1. 克隆存储库：

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

1. 运行提供json数据的web服务器：

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

1. 跑吧 __语义内核__ 基于客户端：

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

或 __微软。扩展。人工智能__ 基于客户端：

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

1. 或者，您可以运行服务器并将VSCode用作客户端：

   Open 'mcp.json' in VSCode and select 'Start' to start the MCP server

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

测试

使用以下命令运行所有测试：

cd mcp_tests
dotnet test

例题

以下是您可以向此MCP服务器提出的一些示例问题：

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

许可证

MIT许可证

______________________________________________________________________

*该项目旨在用于示范和教育目的。*