Dooray MCP Server

Instructions

Implementation Reference

• src/dooray_mcp/tools/members.py:9-77 (handler)

  The MembersTool class implements the core handler logic for the 'dooray_members' tool. The 'handle' method dispatches based on the 'action' parameter to specific member management functions using the DoorayClient.

  class MembersTool:
      """Tool for managing Dooray members."""
      
      def __init__(self, dooray_client):
          """Initialize with Dooray client."""
          self.client = dooray_client
      
      async def handle(self, arguments: Dict[str, Any]) -> str:
          """Handle members tool requests.
          
          Args:
              arguments: Tool arguments containing action and parameters
              
          Returns:
              JSON string with results
          """
          action = arguments.get("action")
          if not action:
              return json.dumps({"error": "Action parameter is required"})
          
          try:
              if action == "search_by_email":
                  return await self._search_by_email(arguments)
              elif action == "search_by_id":
                  return await self._search_by_id(arguments)
              elif action == "get_details":
                  return await self._get_details(arguments)
              elif action == "list_project_members":
                  return await self._list_project_members(arguments)
              else:
                  return json.dumps({"error": f"Unknown action: {action}"})
                  
          except Exception as e:
              logger.error(f"Error in members tool: {e}")
              return json.dumps({"error": str(e)})
      
      async def _search_by_email(self, arguments: Dict[str, Any]) -> str:
          """Search member by email address."""
          email = arguments.get("email")
          if not email:
              return json.dumps({"error": "email is required for search_by_email action"})
          
          result = await self.client.search_member_by_email(email)
          return json.dumps(result, ensure_ascii=False)
      
      async def _search_by_id(self, arguments: Dict[str, Any]) -> str:
          """Search member by user ID."""
          user_id = arguments.get("userId")
          if not user_id:
              return json.dumps({"error": "userId is required for search_by_id action"})
          
          result = await self.client.search_member_by_id(user_id)
          return json.dumps(result, ensure_ascii=False)
      
      async def _get_details(self, arguments: Dict[str, Any]) -> str:
          """Get member details."""
          user_id = arguments.get("userId")
          if not user_id:
              return json.dumps({"error": "userId is required for get_details action"})
          
          result = await self.client.get_member_details(user_id)
          return json.dumps(result, ensure_ascii=False)
      
      async def _list_project_members(self, arguments: Dict[str, Any]) -> str:
          """List members of a project."""
          project_id = arguments.get("projectId")
          
          result = await self.client.list_project_members(project_id)
          return json.dumps(result, ensure_ascii=False)

• src/dooray_mcp/server.py:229-255 (schema)

  Input schema for the 'dooray_members' tool, defining available actions and parameters, registered in the list_tools handler.

  types.Tool(
      name="dooray_members",
      description="Manage Dooray members - search by email/ID, get member details, check project membership",
      inputSchema={
          "type": "object",
          "properties": {
              "action": {
                  "type": "string",
                  "enum": ["search_by_email", "search_by_id", "get_details", "list_project_members"],
                  "description": "Action to perform on members"
              },
              "email": {
                  "type": "string",
                  "description": "Email address (for search_by_email)"
              },
              "userId": {
                  "type": "string",
                  "description": "User ID (for search_by_id/get_details)"
              },
              "projectId": {
                  "type": "string",
                  "description": "Project ID (optional - uses default from environment if not provided)"
              }
          },
          "required": ["action"]
      }
  ),

• src/dooray_mcp/server.py:367-369 (registration)

  Registration and dispatch point in the main tool handler (@app.call_tool()), where MembersTool is instantiated and invoked for 'dooray_members' calls.

  elif name == "dooray_members":
      tool = MembersTool(dooray_client)
      result = await tool.handle(args)

• src/dooray_mcp/server.py:21-21 (registration)

  Import statement for the MembersTool handler class.

  from .tools.members import MembersTool