Git Prompts MCP Server

Instructions

Implementation Reference

• src/git_prompts_mcp_server/server.py:398-406 (handler)

  The FastMCP tool handler and registration for 'git-commit-messages'. It calls GitMethodCollection.get_commit_messages_data to execute the tool logic.
  @APP.tool( name="git-commit-messages", description="Get commit messages between the ancestor and HEAD", ) async def git_commit_messages_tool( ancestor: str = Field(..., description="The ancestor commit hash or branch name"), ) -> list[dict[str, str]]: return await GIT_METHOD_COLLETION.get_commit_messages_data(ancestor)
• src/git_prompts_mcp_server/server.py:124-132 (handler)

  Core handler logic in GitMethodCollection that retrieves commits between ancestor and HEAD using gitpython and formats them as a list of dicts.
  async def get_commit_messages_data(self, ancestor: str) -> list[dict[str, str]]: if not ancestor: raise ValueError("Ancestor argument required") try: commits = _get_commit_history(self.repo, ancestor) return _format_commit_history_as_json_obj(commits) except git.GitCommandError as e: raise ValueError(f"Error executing Git command: {str(e)}")
• src/git_prompts_mcp_server/server.py:53-54 (helper)

  Helper function to iterate and list git commits from ancestor to HEAD.
  def _get_commit_history(repo: git.Repo, ancestor: str) -> list[git.Commit]: return list(repo.iter_commits(rev=f"{ancestor}..HEAD"))
• src/git_prompts_mcp_server/server.py:70-80 (helper)

  Helper function to convert list of git Commit objects to JSON-serializable list of dicts with commit details.
  def _format_commit_history_as_json_obj(commits: list[git.Commit]) -> list[dict[str, str]]: return [ { "hexsha": commit.hexsha, "author": str(commit.author), "create_time": commit.authored_datetime.astimezone(timezone.utc).isoformat(), "message": str(commit.message).strip(), } for commit in commits ]
• src/git_prompts_mcp_server/server.py:403-403 (schema)

  Pydantic input schema for the 'ancestor' parameter using Field.
  ancestor: str = Field(..., description="The ancestor commit hash or branch name"),