MCP Feishu Project Manager

Instructions

Implementation Reference

• src/mcp_server/server.py:103-110 (handler)

  The MCP tool handler for 'get_flow_roles'. Ensures plugin authentication token is obtained and delegates to FSProjClient instance to fetch flow roles configuration.

  @mcp.tool("get_flow_roles")
  def get_flow_roles(work_item_type_key: WorkItemType):
      """获取流程角色配置详情
      Args:
          work_item_type_key: 工作项类型，可选值为"story"、"version"、"issue", 分别对应需求、版本、缺陷。
      """
      client.get_plugin_token()
      return client.get_flow_roles(work_item_type_key)

• src/mcp_server/fsprojclient.py:367-383 (helper)

  Core implementation in FSProjClient that makes the HTTP GET request to the Feishu Project API endpoint for flow roles and handles the response.

  def get_flow_roles(self, work_item_type_key: WorkItemType) -> Dict:
      """获取流程角色配置详情
      
      Args:
          work_item_type_key: 工作项类型标识，可选值为"story"、"version"、"issue"
          
      Returns:
          流程角色配置详情
      """
      response = self._request(
          "GET", 
          f"/open_api/{self.project_key}/flow_roles/{work_item_type_key}"
      )
      err_code = response.get("code", 0)
      if err_code != 0:
          raise Exception(f"获取流程角色配置详情失败，错误码: {err_code}, 错误信息: {response.get('err_msg')}")
      return response.get("data", {})

• src/mcp_server/fsprojclient.py:16-16 (schema)

  Type alias defining the valid input values for the work_item_type_key parameter: story, version, or issue.

  WorkItemType = Literal["story", "version", "issue"]

• src/mcp_server/server.py:103-103 (registration)

  The @mcp.tool decorator registers the get_flow_roles function as an MCP tool with the name 'get_flow_roles'.

  @mcp.tool("get_flow_roles")