Merge pull request #25 from perses/ibakshay/add-tools+enhancements

Enable project creation tool in MCP server

Author: ibakshay

README.md

@@ -157,7 +157,8 @@ To integrate the MCP server with VS Code GitHub Copilot, follow these steps:
 | Tool                         | Description           | Required Parameters |
 | ---------------------------- | --------------------- | ------------------- |
 | `perses_list_projects`       | List all projects     | -                   |
-| `perses_get_project_by_name` | Get a project by name | `project`           |
+| `perses_get_project_by_name` | Get a project by name | `project`              |
+| `perses_create_project`      | Create a new project  | `project`              |
 
 ### Dashboards
 

main.go

@@ -56,7 +56,7 @@ func main() {
 	//Project
 	mcpServer.AddTool(tools.ListProjects(persesClient))
 	mcpServer.AddTool(tools.GetProjectByName(persesClient))
-	// mcpServer.AddTool(tools.CreateProject(persesClient))
+	mcpServer.AddTool(tools.CreateProject(persesClient))
 
 	//Dashboard
 	mcpServer.AddTool(tools.ListDashboards(persesClient))

pkg/tools/projects.go

@@ -33,30 +33,40 @@ func ListProjects(client apiClient.ClientInterface) (tool mcp.Tool, handler serv
 func GetProjectByName(client apiClient.ClientInterface) (tool mcp.Tool, handler server.ToolHandlerFunc) {
 	return mcp.NewTool("perses_get_project_by_name",
 			mcp.WithDescription("Get a project by name"),
-			mcp.WithString("name", mcp.Required(),
+			mcp.WithString("project", mcp.Required(),
 				mcp.Description("Project name"))),
 		func(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
-			name, err := request.RequireString("name")
+			project, err := request.RequireString("project")
 			if err != nil {
 				return mcp.NewToolResultError(err.Error()), nil
 			}
 
-			project, err := client.Project().Get(name)
+			response, err := client.Project().Get(project)
 			if err != nil {
-				return nil, fmt.Errorf("error retrieving project '%s': %w", name, err)
+				return nil, fmt.Errorf("error retrieving project '%s': %w", project, err)
 			}
 
-			projectJSON, err := json.Marshal(project)
+			projectJSON, err := json.Marshal(response)
 			if err != nil {
-				return nil, fmt.Errorf("error marshalling project '%s': %w", name, err)
+				return nil, fmt.Errorf("error marshalling project '%s': %w", project, err)
 			}
 			return mcp.NewToolResultText(string(projectJSON)), nil
 		}
 }
 
 func CreateProject(client apiClient.ClientInterface) (tool mcp.Tool, handler server.ToolHandlerFunc) {
 	return mcp.NewTool("perses_create_project",
-			mcp.WithDescription("Create a new Perses Project"), mcp.WithString("project", mcp.Required())),
+			mcp.WithDescription("Create a new Perses Project"),
+			mcp.WithString("project",
+				mcp.Required(),
+				mcp.Description("Project name")),
+			mcp.WithToolAnnotation(mcp.ToolAnnotation{
+				Title:           "Creates a new project in Perses",
+				ReadOnlyHint:    ToBoolPtr(false),
+				DestructiveHint: ToBoolPtr(false),
+				IdempotentHint:  ToBoolPtr(true),
+				OpenWorldHint:   ToBoolPtr(false),
+			})),
 		func(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
 			project, err := request.RequireString("project")
 			if err != nil {

pkg/tools/utils.go

@@ -0,0 +1,15 @@
+package tools
+
+// ToBoolPtr converts a boolean to a *bool pointer.
+func ToBoolPtr(b bool) *bool {
+	return &b
+}
+
+// ToStringPtr converts a string to a *string pointer.
+// Returns nil if the string is empty.
+func ToStringPtr(s string) *string {
+	if s == "" {
+		return nil
+	}
+	return &s
+}