使用说明
家谱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客户端
-
克隆存储库:
git clone https://github.com/AlfredBr/family_tree_mcp_demo.git -
运行提供json数据的web服务器:
dotnet run --project family_tree_mcp_demo/family_webapi/family_webapi.csproj -
跑吧 语义内核 基于客户端:
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 -
或者,您可以运行服务器并将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许可证
该项目旨在用于示范和教育目的。