CV Resume Builder MCP

Instructions

Implementation Reference

• src/cv_resume_builder_mcp/server.py:412-429 (handler)

  The implementation of the list_repos tool handler. It iterates over the REPO_DICT, formats a list of configured repositories with paths, adds total count and usage instructions, and returns as TextContent.

  async def list_repos_tool() -> list[TextContent]:
      """List all configured repositories."""
      if not REPO_DICT:
          return [TextContent(
              type="text",
              text="No repositories configured"
          )]
      
      output = "Configured Repositories:\n\n"
      for name, path in REPO_DICT.items():
          output += f"- {name}: {path}\n"
      
      output += f"\nTotal: {len(REPO_DICT)} repository" + ("ies" if len(REPO_DICT) > 1 else "")
      output += "\n\nUsage:\n"
      output += "- Use 'get_git_log_by_repo' to get commits from a specific repo\n"
      output += "- Use 'get_git_log_all_repos' to get commits from all repos"
      
      return [TextContent(type="text", text=output)]

• src/cv_resume_builder_mcp/server.py:116-123 (registration)

  Registration of the list_repos tool in the @app.list_tools() function, specifying the name, description, and empty input schema (no parameters required).

  Tool(
      name="list_repos",
      description="List all configured git repositories",
      inputSchema={
          "type": "object",
          "properties": {}
      }
  ),

• src/cv_resume_builder_mcp/server.py:119-122 (schema)

  Input schema for the list_repos tool, defining an object with no properties (no input parameters needed).

  inputSchema={
      "type": "object",
      "properties": {}
  }

• src/cv_resume_builder_mcp/server.py:312-313 (handler)

  Dispatch logic in the @app.call_tool() handler that routes calls to the list_repos tool to the list_repos_tool function.

  elif name == "list_repos":
      return await list_repos_tool()

• src/cv_resume_builder_mcp/server.py:29-48 (helper)

  Helper function parse_repos() that parses the REPOS environment variable into REPO_DICT, which is used by list_repos_tool to list repositories. Includes fallbacks for REPO_PATH and current directory.

  def parse_repos() -> dict:
      """Parse REPOS environment variable into a dictionary."""
      repos = {}
      
      # Parse REPOS if provided
      if REPOS:
          for repo_entry in REPOS.split(","):
              if ":" in repo_entry:
                  name, path = repo_entry.split(":", 1)
                  repos[name.strip()] = path.strip()
      
      # Backward compatibility: if REPO_PATH is set and no REPOS, use it as default
      if REPO_PATH and not repos:
          repos["default"] = REPO_PATH
      
      # If nothing configured, use current directory as default
      if not repos:
          repos["default"] = os.getcwd()
      
      return repos