get_view_list
Retrieve a list of project views from Feishu by specifying the work item type, such as story, version, or issue, for streamlined project management insights.
Instructions
获取飞书项目视图列表 Args: work_item_type_key: 工作项类型,可选值为"story"、"version"、"issue", 分别对应需求、版本、缺陷。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| work_item_type_key | Yes |
Implementation Reference
- src/mcp_server/server.py:41-48 (handler)MCP tool handler for 'get_view_list'. Ensures plugin token validity and delegates to FSProjClient.get_view_list method.@mcp.tool("get_view_list") def get_view_list(work_item_type_key: WorkItemType): """获取当前飞书项目下的某一类型工作项的所有视图列表 Args: work_item_type_key: 工作项类型,可选值为"story"、"version"、"issue", 分别对应需求、版本、缺陷。 """ client.get_plugin_token() return client.get_view_list(work_item_type_key)
- src/mcp_server/fsprojclient.py:16-16 (schema)Type alias defining valid WorkItemType values used in get_view_list tool parameters.WorkItemType = Literal["story", "version", "issue"]
- Core implementation in FSProjClient that performs the API POST request to retrieve the view list for the specified work item type.def get_view_list(self, work_item_type_key: WorkItemType, created_by: str = "", page_num: int = 1, page_size: int = 100) -> Dict: """获取视图列表及配置信息 Args: work_item_type_key: 工作项类型标识 created_by: 创建者标识 page_num: 页码 page_size: 每页数量 Returns: 视图列表及配置信息 """ data = { "work_item_type_key": work_item_type_key, "page_num": page_num, "page_size": page_size, "created_by": created_by } response = self._request( "POST", f"/open_api/{self.project_key}/view_conf/list", json_data=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:41-41 (registration)Registration of the 'get_view_list' tool with the MCP server using the @mcp.tool decorator.@mcp.tool("get_view_list")