家族树查询服务

一个用于探索和查询虚构家族树的模型上下文协议(MCP)服务器,提供检索、添加和更新家族成员及其关系的工具。

  • by AlfredBr
  • C#
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 AlfredBr/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",
                "<your_path>\\mcp_server\\mcp_server.csproj"
            ]
        }
    }
}

入门指南

先决条件

运行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. 跑吧 语义内核 基于客户端:

    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
    
  4. 或者,您可以运行服务器并将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许可证


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