Gatherings MCP Server

Instructions

Implementation Reference

• src/index.ts:176-183 (registration)

  Registration of the 'list_gatherings' tool including name, description, and empty input schema in the MCP server's ListTools response.

  {
    name: 'list_gatherings',
    description: 'List all gatherings',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  },

• src/index.ts:338-340 (handler)

  MCP tool handler case that constructs the CLI command to execute the Python script with 'list' subcommand.

  command += ' list';
  break;

• gatherings.py:284-315 (handler)

  CLI handler for the 'list' command invoked by the MCP server, which fetches gatherings and outputs the list in JSON or human-readable format.

  def handle_list(service, args):
      """Handle the list command."""
      try:
          gatherings = service.list_gatherings()
          result = {
              "success": True,
              "gatherings": [
                  {
                      "id": g.id,
                      "status": g.status.value
                  }
                  for g in gatherings
              ] if gatherings else []
          }
          
          if args.json:
              print(json.dumps(result))
          else:
              if not gatherings:
                  print("No gatherings found")
              else:
                  print(f"Found {len(gatherings)} gatherings:")
                  for gathering in gatherings:
                      print(f"  {gathering.id} - Status: {gathering.status.value}")
          return True
      except ValueError as e:
          error = {"success": False, "error": str(e)}
          if args.json:
              print(json.dumps(error))
          else:
              print(f"Error: {e}")
          return False

• services.py:160-167 (helper)

  GatheringService method that delegates listing of gatherings to the DatabaseManager.

  def list_gatherings(self) -> List[Gathering]:
      """
      List all gatherings.
      
      Returns:
          A list of all Gathering objects
      """
      return self.db_manager.list_gatherings()

• models.py:617-630 (helper)

  DatabaseManager method that queries the database for all Gathering records, implementing the core data retrieval logic.

  def list_gatherings(self) -> List[Gathering]:
      """
      List all gatherings.
      
      Returns:
          A list of all Gathering objects
      """
      session = self.Session()
      try:
          # Get all gatherings
          gatherings = session.query(Gathering).all()
          return gatherings
      finally:
          session.close()