mcp-mizra-groups

castroi/mcp-mizra-groups

3.2

If you are the rightful owner of mcp-mizra-groups and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Mizra Member & Group Search MCP Server is designed to facilitate querying of Mizra members and groups using Hebrew names and group creation years, with seamless integration into Goose AI.

Tools

  1. find_members_by_name

    Search members using Hebrew name components.

  2. find_members_by_group

    Get members of a specific Hebrew-named group.

  3. find_groups_by_year

    Find groups created in a specific year.

Mizra Member & Group Search - MCP Server

A Model Context Protocol (MCP) server for querying Mizra members and groups by Hebrew name, group name, or year. Designed to integrate with Goose AI as an extension.

๐Ÿ”ง Features

  • Search Members by Hebrew Name: First name, last name, or both.
  • Search Members by Group: Find all members in a specific Hebrew-named group.
  • Search Groups by Year: List groups created in a specific year.
  • Goose AI Integration: Works seamlessly with Goose's MCP extension system.

๐Ÿงช Available Tools

1. find_members_by_name

Purpose: Search members using Hebrew name components.
Parameters:

  • first_name (optional): Hebrew first name.
  • last_name (optional): Hebrew last name.

Returns:

{
  "members": [
    {
      "firstName": "ืจื•ืื™",
      "lastName": "ืฉืžื™ืจ",
      "groupName": "Group A",
      "year": 2023
    }
  ]
}

Example:

find_members_by_name(first_name="ืจื•ืื™", last_name="ืฉืžื™ืจ")

2. find_members_by_group

Purpose: Get members of a specific Hebrew-named group.
Parameters:

  • group_name: Hebrew group name (e.g., ืขื•ืžืจ).

Returns:

{
  "members": ["ืจื•ืื™ ืฉืžื™ืจ", "ื™ื•ื ืชืŸ ื›ื”ืŸ"]
}

Example:

find_members_by_group(group_name="Group A")

3. find_groups_by_year

Purpose: Find groups created in a specific year.
Parameters:

  • year: Year as a string (e.g., "2023").

Returns:

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

๐Ÿš€ Installation & Setup

Prerequisites

  • Python 3.10+
  • uv (for dependency management)

1. Install Dependencies

uv add "mcp[cli]"

2. Clone the Repo

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

๐Ÿงช Testing with MCP Inspector

Use the MCP Inspector to debug your server:

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

Then visit http://127.0.0.1:6274 to interact with the tools.

๐Ÿ“š Dependencies

  • mcp[cli]: FastMCP server implementation.
  • uv: Fast Python dependency manager.

โ–ถ๏ธ Usage

Run the Server

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

Testing the CLI

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

Integrate with Goose AI

Goose AI

To add your MCP server as an extension in Goose: Go to Settings > Extensions > Add. Provide the ID, name, and description for your extension. In the Command field, provide the absolute path to your executable. For example:

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

More details: https://block.github.io/goose/docs/tutorials/custom-extensions

๐Ÿ“Œ License

MIT License.