change some descriptions (#23)

* change some descriptions

* Update pkg/github/repositories.go

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: juruen

pkg/github/issues.go

@@ -60,7 +60,7 @@ func getIssue(client *github.Client) (tool mcp.Tool, handler server.ToolHandlerF
 // addIssueComment creates a tool to add a comment to an issue.
 func addIssueComment(client *github.Client) (tool mcp.Tool, handler server.ToolHandlerFunc) {
 	return mcp.NewTool("add_issue_comment",
-			mcp.WithDescription("Add a comment to an issue"),
+			mcp.WithDescription("Add a comment to an existing issue"),
 			mcp.WithString("owner",
 				mcp.Required(),
 				mcp.Description("Repository owner"),
@@ -114,7 +114,7 @@ func addIssueComment(client *github.Client) (tool mcp.Tool, handler server.ToolH
 // searchIssues creates a tool to search for issues and pull requests.
 func searchIssues(client *github.Client) (tool mcp.Tool, handler server.ToolHandlerFunc) {
 	return mcp.NewTool("search_issues",
-			mcp.WithDescription("Search for issues and pull requests"),
+			mcp.WithDescription("Search for issues and pull requests across GitHub repositories"),
 			mcp.WithString("q",
 				mcp.Required(),
 				mcp.Description("Search query using GitHub issues search syntax"),

pkg/github/repositories.go

@@ -16,7 +16,7 @@ import (
 // listCommits creates a tool to get commits of a branch in a repository.
 func listCommits(client *github.Client) (tool mcp.Tool, handler server.ToolHandlerFunc) {
 	return mcp.NewTool("list_commits",
-			mcp.WithDescription("Gets commits of a branch in a repository"),
+			mcp.WithDescription("Get list of commits of a branch in a GitHub repository"),
 			mcp.WithString("owner",
 				mcp.Required(),
 				mcp.Description("Repository owner"),
@@ -85,7 +85,7 @@ func listCommits(client *github.Client) (tool mcp.Tool, handler server.ToolHandl
 // createOrUpdateFile creates a tool to create or update a file in a GitHub repository.
 func createOrUpdateFile(client *github.Client) (tool mcp.Tool, handler server.ToolHandlerFunc) {
 	return mcp.NewTool("create_or_update_file",
-			mcp.WithDescription("Create or update a single file in a repository"),
+			mcp.WithDescription("Create or update a single file in a GitHub repository"),
 			mcp.WithString("owner",
 				mcp.Required(),
 				mcp.Description("Repository owner (username or organization)"),
@@ -164,7 +164,7 @@ func createOrUpdateFile(client *github.Client) (tool mcp.Tool, handler server.To
 // createRepository creates a tool to create a new GitHub repository.
 func createRepository(client *github.Client) (tool mcp.Tool, handler server.ToolHandlerFunc) {
 	return mcp.NewTool("create_repository",
-			mcp.WithDescription("Create a new GitHub repository"),
+			mcp.WithDescription("Create a new GitHub repository in your account"),
 			mcp.WithString("name",
 				mcp.Required(),
 				mcp.Description("Repository name"),
@@ -227,7 +227,7 @@ func createRepository(client *github.Client) (tool mcp.Tool, handler server.Tool
 // getFileContents creates a tool to get the contents of a file or directory from a GitHub repository.
 func getFileContents(client *github.Client) (tool mcp.Tool, handler server.ToolHandlerFunc) {
 	return mcp.NewTool("get_file_contents",
-			mcp.WithDescription("Get contents of a file or directory"),
+			mcp.WithDescription("Get the contents of a file or directory from a GitHub repository"),
 			mcp.WithString("owner",
 				mcp.Required(),
 				mcp.Description("Repository owner (username or organization)"),
@@ -287,7 +287,7 @@ func getFileContents(client *github.Client) (tool mcp.Tool, handler server.ToolH
 // forkRepository creates a tool to fork a repository.
 func forkRepository(client *github.Client) (tool mcp.Tool, handler server.ToolHandlerFunc) {
 	return mcp.NewTool("fork_repository",
-			mcp.WithDescription("Fork a repository"),
+			mcp.WithDescription("Fork a GitHub repository to your account or specified organization"),
 			mcp.WithString("owner",
 				mcp.Required(),
 				mcp.Description("Repository owner"),
@@ -344,7 +344,7 @@ func forkRepository(client *github.Client) (tool mcp.Tool, handler server.ToolHa
 // createBranch creates a tool to create a new branch.
 func createBranch(client *github.Client) (tool mcp.Tool, handler server.ToolHandlerFunc) {
 	return mcp.NewTool("create_branch",
-			mcp.WithDescription("Create a new branch"),
+			mcp.WithDescription("Create a new branch in a GitHub repository"),
 			mcp.WithString("owner",
 				mcp.Required(),
 				mcp.Description("Repository owner"),

pkg/github/server.go

@@ -72,7 +72,7 @@ func NewServer(client *github.Client) *server.MCPServer {
 // getMe creates a tool to get details of the authenticated user.
 func getMe(client *github.Client) (tool mcp.Tool, handler server.ToolHandlerFunc) {
 	return mcp.NewTool("get_me",
-			mcp.WithDescription("Get details of the authenticated user."),
+			mcp.WithDescription("Get details of the authenticated GitHub user"),
 			mcp.WithString("reason",
 				mcp.Description("Optional: reason the session was created"),
 			),