feat: add MCP resources for hotness and collection (v1.5.1)

Author: kkjdaniel

README.md

@@ -56,6 +56,17 @@ Game recommendations are powered by [Recommend.Games](https://recommend.games/),
 | ----------- | ------------------------------------------------------------------------------------------ |
 | `bgg-rules` | Answer rules questions by searching BGG forums for relevant discussions and clarifications |
 
+## Resources
+
+BGG MCP exposes resources that AI assistants can access directly for contextual information:
+
+| Resource              | URI                   | Description                                                       |
+| --------------------- | --------------------- | ----------------------------------------------------------------- |
+| `BGG Hotness`         | `bgg://hotness`       | Current BGG hotness list, always available                        |
+| `My BGG Collection`   | `bgg://my-collection` | Your personal BGG collection (requires `BGG_USERNAME` to be set)  |
+
+Resources provide AI assistants with direct access to BGG data without needing explicit tool calls, making conversations more natural and efficient.
+
 ## Prompts
 
 - **Trade Sales Post** - Generate a formatted sales post for your BGG 'for trade' collection with discounted market prices

main.go

@@ -12,6 +12,7 @@ import (
 	"time"
 
 	"github.com/kkjdanie/bgg-mcp/prompts"
+	"github.com/kkjdanie/bgg-mcp/resources"
 	"github.com/kkjdanie/bgg-mcp/tools"
 	"github.com/kkjdaniel/gogeek/v2"
 	"github.com/mark3labs/mcp-go/server"
@@ -54,7 +55,7 @@ func createClientFromSessionConfig(apiKey, cookie string) *gogeek.Client {
 func createMCPServer(client *gogeek.Client) *server.MCPServer {
 	s := server.NewMCPServer(
 		"BGG MCP",
-		"1.4.0",
+		"1.5.1",
 		server.WithResourceCapabilities(true, true),
 		server.WithPromptCapabilities(true),
 		server.WithLogging(),
@@ -91,6 +92,12 @@ func createMCPServer(client *gogeek.Client) *server.MCPServer {
 	threadDetailsTool, threadDetailsHandler := tools.ThreadDetailsTool(client)
 	s.AddTool(threadDetailsTool, threadDetailsHandler)
 
+	hotnessResource, hotnessResourceHandler := resources.HotnessResource(client)
+	s.AddResource(hotnessResource, hotnessResourceHandler)
+
+	myCollectionResource, myCollectionResourceHandler := resources.MyCollectionResource(client)
+	s.AddResource(myCollectionResource, myCollectionResourceHandler)
+
 	prompts.RegisterPrompts(s)
 
 	return s

resources/collection.go

@@ -0,0 +1,67 @@
+package resources
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"os"
+
+	"github.com/kkjdaniel/gogeek/v2"
+	"github.com/kkjdaniel/gogeek/v2/collection"
+	"github.com/mark3labs/mcp-go/mcp"
+	"github.com/mark3labs/mcp-go/server"
+)
+
+func MyCollectionResource(client *gogeek.Client) (mcp.Resource, server.ResourceHandlerFunc) {
+	username := os.Getenv("BGG_USERNAME")
+
+	var description string
+	if username != "" {
+		description = fmt.Sprintf("Your BoardGameGeek collection (user: %s). Shows all owned games with their ratings, play counts, and status.", username)
+	} else {
+		description = "Your BoardGameGeek collection. Requires BGG_USERNAME environment variable to be set."
+	}
+
+	resource := mcp.NewResource(
+		"bgg://my-collection",
+		"My BGG Collection",
+		mcp.WithResourceDescription(description),
+		mcp.WithMIMEType("application/json"),
+	)
+
+	handler := func(ctx context.Context, request mcp.ReadResourceRequest) ([]mcp.ResourceContents, error) {
+		if username == "" {
+			return nil, fmt.Errorf("BGG_USERNAME environment variable not set")
+		}
+
+		result, err := collection.Query(client, username, collection.WithOwned(true))
+		if err != nil {
+			return nil, fmt.Errorf("error fetching collection: %v", err)
+		}
+
+		if len(result.Items) == 0 {
+			return []mcp.ResourceContents{
+				&mcp.TextResourceContents{
+					URI:      "bgg://my-collection",
+					MIMEType: "application/json",
+					Text:     "[]",
+				},
+			}, nil
+		}
+
+		out, err := json.Marshal(result.Items)
+		if err != nil {
+			return nil, fmt.Errorf("error formatting results: %v", err)
+		}
+
+		return []mcp.ResourceContents{
+			&mcp.TextResourceContents{
+				URI:      "bgg://my-collection",
+				MIMEType: "application/json",
+				Text:     string(out),
+			},
+		}, nil
+	}
+
+	return resource, handler
+}

resources/hotness.go

@@ -0,0 +1,53 @@
+package resources
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+
+	"github.com/kkjdaniel/gogeek/v2"
+	"github.com/kkjdaniel/gogeek/v2/hot"
+	"github.com/mark3labs/mcp-go/mcp"
+	"github.com/mark3labs/mcp-go/server"
+)
+
+func HotnessResource(client *gogeek.Client) (mcp.Resource, server.ResourceHandlerFunc) {
+	resource := mcp.NewResource(
+		"bgg://hotness",
+		"Current BGG Hotness List",
+		mcp.WithResourceDescription("The current list of hot board games on BoardGameGeek, updated regularly by the BGG community"),
+		mcp.WithMIMEType("application/json"),
+	)
+
+	handler := func(ctx context.Context, request mcp.ReadResourceRequest) ([]mcp.ResourceContents, error) {
+		hotItems, err := hot.Query(client, hot.ItemTypeBoardGame)
+		if err != nil {
+			return nil, fmt.Errorf("error fetching hotness list: %v", err)
+		}
+
+		if len(hotItems.Items) == 0 {
+			return []mcp.ResourceContents{
+				&mcp.TextResourceContents{
+					URI:      "bgg://hotness",
+					MIMEType: "application/json",
+					Text:     "[]",
+				},
+			}, nil
+		}
+
+		out, err := json.Marshal(hotItems.Items)
+		if err != nil {
+			return nil, fmt.Errorf("error formatting results: %v", err)
+		}
+
+		return []mcp.ResourceContents{
+			&mcp.TextResourceContents{
+				URI:      "bgg://hotness",
+				MIMEType: "application/json",
+				Text:     string(out),
+			},
+		}, nil
+	}
+
+	return resource, handler
+}

server.json

@@ -7,11 +7,11 @@
     "url": "https://github.com/kkjdaniel/bgg-mcp",
     "source": "github"
   },
-  "version": "1.5.0",
+  "version": "1.5.1",
   "packages": [
     {
       "registryType": "oci",
-      "identifier": "docker.io/kdaniel/bgg-mcp:1.5.0",
+      "identifier": "docker.io/kdaniel/bgg-mcp:1.5.1",
       "transport": {
         "type": "stdio"
       },