成员与群组搜索服务

一个基于模型上下文协议(MCP)的服务器,用于通过希伯来语名称、群组名称或年份查询Mizra成员和群组,可与Goose AI集成。

  • by castroi
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 castroi/mcp-mizra-groups

使用说明

Mizra成员和组搜索-MCP服务器

一种模型上下文协议(MCP)服务器,用于按希伯来语名称、组名或年份查询Mizra成员和组。旨在与 鹅AI 作为一种延伸。


🔧 特性

  • 按希伯来语名称搜索成员:名字、姓氏,或两者兼而有之。
  • 按组搜索成员:查找特定希伯来语命名组中的所有成员。
  • 按年份搜索组:列出在特定年份创建的组。
  • Goose AI集成:与Goose的MCP扩展系统无缝协作。

🧪 可用工具

1. find_members_by_name

目的:使用希伯来语名称组件搜索成员。
参数:

  • first_name (可选):希伯来语名字。
  • last_name (可选):希伯来语姓氏。

退货:

{
  "members": [
    {
      "firstName": "רואי",
      "lastName": "שמיר",
      "groupName": "Group A",
      "year": 2023
    }
  ]
}

示例:

find_members_by_name(first_name="רואי", last_name="שמיר")

2. find_members_by_group

目的:获取特定希伯来语命名组的成员。
参数:

  • group_name:希伯来语组名(例如。, עומר).

退货:

{
  "members": ["רואי שמיר", "יונתן כהן"]
}

示例:

find_members_by_group(group_name="Group A")

3. find_groups_by_year

目的:查找在特定年份创建的组。
参数:

  • year:年份作为字符串(例如。, "2023").

退货:

{
  "groups": ["Group A", "Group B"]
}

🚀 安装和设置

先决条件

  • Python 3.10+
  • uv (用于依赖关系管理)

1.安装依赖项

uv add "mcp[cli]"

2.克隆Repo

git clone https://github.com/castroi/mcp-mizra-groups.git
cd mcp-mizra-groups

🧪 MCP检验员测试

使用 MCP检查员 要调试服务器,请执行以下操作:

uv sync
source .venv/bin/activate
mcp dev src/mcp_mizra_groups/server.py

然后访问 http://127.0.0.1:6274 与工具进行交互。


📚 依赖项

  • mcp[cli]:FastMCP服务器实现。
  • uv:快速Python依赖管理器。

▶️ 用法

运行服务器

source .venv/bin/activate
mcp dev src/mcp_mizra_groups/server.py

测试CLI

uv pip install .
ls .venv/bin/  # Verify your CLI is available
mcp-mizra-groups --help

与Goose AI集成

鹅AI

要在Goose中将MCP服务器添加为扩展: 前往“设置”>“扩展”>“添加”。 提供您的扩展名的ID、名称和描述。 在命令字段中,提供可执行文件的绝对路径。例如:

uv run /home/user/mcp-mizra-groups/.venv/bin/mcp-mizra-groups

更多详情: https://block.github.io/goose/docs/tutorials/custom-extensions


📌 许可证

MIT许可证。