list_projects
Retrieve accessible GitLab projects with search filters and pagination controls to manage project visibility.
Instructions
列出可存取的 GitLab 專案
Args: search: 搜尋關鍵字（專案名稱） membership: 僅列出已加入的專案（預設 True） page: 頁碼（預設 1） per_page: 每頁筆數（預設 20，最大 100）
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search | No | ||
| membership | No | ||
| page | No | ||
| per_page | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/gitlab_mcp/server.py:68-98 (handler)The 'list_projects' MCP tool implementation in server.py. It handles tool registration with @mcp.tool(), validates input via GitLab client, and formats the output for the user.
@mcp.tool() def list_projects(search: str = None, membership: bool = True, page: int = 1, per_page: int = 20) -> str: """列出可存取的 GitLab 專案 Args: search: 搜尋關鍵字（專案名稱） membership: 僅列出已加入的專案（預設 True） page: 頁碼（預設 1） per_page: 每頁筆數（預設 20，最大 100） """ try: client = get_client() projects = client.list_projects(search=search, membership=membership, page=page, per_page=per_page) if not projects: return "找不到符合條件的專案" lines = [f"找到 {len(projects)} 個專案：\n"] for p in projects: desc = p.get("description") or "" if len(desc) > 60: desc = desc[:60] + "..." lines.append( f"- [{p['id']}] {p['path_with_namespace']}" f"\n {desc}" f"\n 預設分支: {p.get('default_branch', 'N/A')} | {p.get('web_url', '')}\n" ) return "\n".join(lines) except GitLabAPIError as e: return f"列出專案失敗: {str(e)}"