MCP Feishu Project Manager

Instructions

Implementation Reference

• src/mcp_server/server.py:50-59 (handler)

  MCP tool handler function for 'get_view_detail' that handles authentication and delegates to FSProjClient.get_view_detail. Includes input schema via type hints and docstring.

  @mcp.tool("get_view_detail")
  def get_view_detail(view_id: str, page_num: int = 1, page_size: int = 20):
      """根据视图id获取指定视图下的工作项列表
      Args:
          view_id: 视图标识id
          page_num: 页码，默认为1
          page_size: 每页数量，默认为20
      """
      client.get_plugin_token()
      return client.get_view_detail(view_id, page_num, page_size)

• src/mcp_server/fsprojclient.py:299-322 (helper)

  Core implementation of get_view_detail in FSProjClient class, performing the actual API GET request to retrieve view details with pagination.

  def get_view_detail(self, view_id: str, page_num: int = 1, page_size: int = 20) -> Dict:
      """获取视图工作项列表
      
      Args:
          view_id: 视图标识
          page_num: 页码
          page_size: 每页数量
          
      """
      
      data = {
          "page_num": page_num,
          "page_size": page_size
      }
      response = self._request(
          "GET", 
          f"/open_api/{self.project_key}/fix_view/{view_id}", 
          params=data
      )
      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/server.py:50-50 (registration)

  Registration of the 'get_view_detail' tool using FastMCP decorator.

  @mcp.tool("get_view_detail")