Sefaria Jewish Library MCP Server

Instructions

Implementation Reference

• src/sefaria_jewish_library/sefaria_handler.py:109-113 (handler)

  Core handler function implementing the logic for the 'get_text' tool by fetching Hebrew text via helper.

  async def get_text(reference: str) -> str:
      """
      Retrieves the text for a given reference.
      """
      return str(get_hebrew_text(reference))

• src/sefaria_jewish_library/server.py:146-165 (handler)

  Dispatch handler in call_tool that extracts arguments and invokes the get_text function.

  if name == "get_text":
      try:
          reference = arguments.get("reference")
          if not  reference:
              raise ValueError("Missing reference parameter")  
          
          logger.debug(f"handle_get_text: {reference}")
          text = await get_text(reference)
          
          
          return [types.TextContent(
              type="text",
              text= text
          )]
      except Exception as err:
          logger.error(f"retreive text error: {err}", exc_info=True)
          return [types.TextContent(
              type="text",
              text=f"Error: {str(err)}"
          )]

• src/sefaria_jewish_library/server.py:40-48 (schema)

  JSON schema defining the input parameters for the 'get_text' tool (requires 'reference' string).

      "type": "object",
      "properties": {
          "reference": {
              "type": "string",
              "description": "The reference of the jewish text, e.g. 'שולחן ערוך אורח חיים סימן א' or 'Genesis 1:1'",                               
          },
      },
      "required": ["reference"],
  },

• src/sefaria_jewish_library/server.py:37-49 (registration)

  Registration of the 'get_text' tool in the server's list_tools response.

      name="get_text",
      description="get a jewish text from the jewish library",
      inputSchema={
          "type": "object",
          "properties": {
              "reference": {
                  "type": "string",
                  "description": "The reference of the jewish text, e.g. 'שולחן ערוך אורח חיים סימן א' or 'Genesis 1:1'",                               
              },
          },
          "required": ["reference"],
      },
  ),

• src/sefaria_jewish_library/sefaria_handler.py:68-79 (helper)

  Supporting helper that performs the actual API request to retrieve Hebrew text from Sefaria.

  def get_hebrew_text(parasha_ref):
      """
      Retrieves the Hebrew text and version title for the given verse.
      """
      data = get_request_json_data("api/v3/texts/", parasha_ref)
  
      if data and "versions" in data and len(data['versions']) > 0:
          he_pasuk = data['versions'][0]['text']
          return  he_pasuk
      else:
          print(f"Could not retrieve Hebrew text for {parasha_ref}")
          return None