feat: add helper methods for tool and resource registration

Add convenience methods to simplify MCP server feature registration:

- Add AddTool[In, Out] package-level generic function for type-safe tool registration
- Add Server.AddResource method for resource registration
- Add Server.AddResourceTemplate method for resource template registration
- All helpers automatically increment internal counters for accurate stats

These methods eliminate the need for users to:
- Call srv.MCP() to access the underlying MCP server
- Manually increment tool/resource counters after registration

All changes are additive and backwards compatible.

Additional changes:
- Fix branding: replace all 'MCPBase' references with 'hypermcp' in DOCKER.md
- Update README.md with new API examples and documentation structure
- Update EXAMPLE.md to demonstrate new simplified registration pattern
- Clean up go.sum dependencies

Author: Rihoj

DOCKER.md

@@ -1,6 +1,6 @@
-# Docker Deployment Guide for MCPBase Servers
+# Docker Deployment Guide for hypermcp Servers
 
-This guide covers containerizing and deploying MCP servers built with MCPBase.
+This guide covers containerizing and deploying MCP servers built with hypermcp.
 
 ## 📋 Table of Contents
 - [Quick Start](#quick-start)
@@ -15,7 +15,7 @@ This guide covers containerizing and deploying MCP servers built with MCPBase.
 
 ### 1. Copy the Example Dockerfile
 ```bash
-cp pkg/mcpbase/Dockerfile.example ./Dockerfile
+cp Dockerfile.example ./Dockerfile
 ```
 
 ### 2. Build Your Image
@@ -357,4 +357,4 @@ docker run --rm -it --entrypoint /bin/sh my-mcp-server:latest
 
 ---
 
-**Need help?** Check the main MCPBase documentation or open an issue!
+**Need help?** Check the main hypermcp documentation or open an issue!

EXAMPLE.md

@@ -89,9 +89,9 @@ type EchoOutput struct {
 
 // registerTools registers all tools with the MCP server
 func registerTools(srv *hypermcp.Server, logger *zap.Logger) {
-	// Register a simple echo tool
-	mcp.AddTool(
-		srv.MCP(),
+	// Register a simple echo tool using the helper function
+	hypermcp.AddTool(
+		srv,
 		&mcp.Tool{
 			Name:        "echo",
 			Description: "Echo back a message",
@@ -101,11 +101,10 @@ func registerTools(srv *hypermcp.Server, logger *zap.Logger) {
 			return nil, EchoOutput{Echo: input.Message}, nil
 		},
 	)
-	srv.IncrementToolCount()
 
 	// Add more tools here...
 }
-\`\`\`
+```
 
 ## Build and Run
 

README.md

@@ -110,16 +110,17 @@ func registerFeatures(srv *hypermcp.Server) {
     // Create providers
     myProvider := providers.NewMyProvider(srv)
 
-    // Register tools
-    srv.AddTool(
+    // Register tools using the helper function
+    hypermcp.AddTool(
+        srv,
         &mcp.Tool{
             Name:        "my_tool",
             Description: "Does something cool",
         },
         myProvider.MyTool,
     )
 
-    // Register resources
+    // Register resources using the helper method
     srv.AddResource(
         &mcp.Resource{
             URI:         "myresource://data",
@@ -161,13 +162,18 @@ type Config struct {
 - `Cache() *cache.Cache` - Get the cache instance
 - `Logger() *zap.Logger` - Get the logger
 - `MCP() *mcp.Server` - Get the underlying MCP server
-- `AddTool(tool, handler)` - Register a tool
-- `AddResource(resource, handler)` - Register a resource
-- `AddResourceTemplate(template, handler)` - Register a resource template
+- `AddResource(resource, handler)` - Register a resource (auto-increments counter)
+- `AddResourceTemplate(template, handler)` - Register a resource template (auto-increments counter)
 - `LogRegistrationStats()` - Log tool/resource counts
 - `Run(ctx, transport)` - Start the server
 - `Shutdown(ctx)` - Gracefully shutdown
 
+### Package-Level Functions
+
+- `AddTool[In, Out](srv, tool, handler)` - Register a tool (auto-increments counter)
+- `New(cfg, logger)` - Create a new server instance
+- `RunWithTransport(ctx, srv, transportType, logger)` - Start server with specified transport
+
 ### Transport
 
 ```go

go.sum

@@ -26,14 +26,10 @@ github.com/yosida95/uritemplate/v3 v3.0.2 h1:Ed3Oyj9yrmi9087+NczuL5BwkIc4wvTb5zI
 github.com/yosida95/uritemplate/v3 v3.0.2/go.mod h1:ILOh0sOhIJR3+L/8afwt/kE++YT040gmv5BQTMR2HP4=
 go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
 go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
-go.uber.org/multierr v1.10.0 h1:S0h4aNzvfcFsC3dRF1jLoaov7oRaKqRGC/pUEJ2yvPQ=
-go.uber.org/multierr v1.10.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
 go.uber.org/multierr v1.11.0 h1:blXXJkSxSSfBVBlC76pxqeO+LN3aDfLQo+309xJstO0=
 go.uber.org/multierr v1.11.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
 go.uber.org/zap v1.27.0 h1:aJMhYGrd5QSmlpLMr2MftRKl7t8J8PTZPA732ud/XR8=
 go.uber.org/zap v1.27.0/go.mod h1:GB2qFLM7cTU87MWRP2mPIjqfIDnGu+VIO4V/SdhGo2E=
-golang.org/x/sys v0.25.0 h1:r+8e+loiHxRqhXVl6ML1nO3l1+oFoWbnlu2Ehimmi34=
-golang.org/x/sys v0.25.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
 golang.org/x/sys v0.37.0 h1:fdNQudmxPjkdUTPnLn5mdQv7Zwvbvpaxqs831goi9kQ=
 golang.org/x/sys v0.37.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
 golang.org/x/tools v0.34.0 h1:qIpSLOxeCYGg9TrcJokLBG4KFA6d795g0xkBkiESGlo=

server.go

@@ -123,6 +123,24 @@ func (s *Server) Run(ctx context.Context, transport mcp.Transport) error {
 	return s.mcp.Run(ctx, transport)
 }
 
+// AddTool registers a tool with the MCP server and increments the tool counter
+func AddTool[In, Out any](s *Server, tool *mcp.Tool, handler mcp.ToolHandlerFor[In, Out]) {
+	mcp.AddTool(s.mcp, tool, handler)
+	s.IncrementToolCount()
+}
+
+// AddResource registers a resource with the MCP server and increments the resource counter
+func (s *Server) AddResource(resource *mcp.Resource, handler mcp.ResourceHandler) {
+	s.mcp.AddResource(resource, handler)
+	s.IncrementResourceCount()
+}
+
+// AddResourceTemplate registers a resource template with the MCP server and increments the resource counter
+func (s *Server) AddResourceTemplate(template *mcp.ResourceTemplate, handler mcp.ResourceHandler) {
+	s.mcp.AddResourceTemplate(template, handler)
+	s.IncrementResourceCount()
+}
+
 // Shutdown performs cleanup
 func (s *Server) Shutdown(ctx context.Context) error {
 	s.logger.Info("shutting down server")