Merge pull request #1 from chickenzord/feat/github-workflows

feat: github workflows

Author: akhy

.github/dependabot.yml

@@ -0,0 +1,13 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "gomod" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: build(deps)

.github/workflows/docker.yml

@@ -0,0 +1,60 @@
+name: Docker
+
+on:
+  push:
+    branches:
+      - 'main'
+    tags:
+      - 'v*'
+  pull_request:
+    branches:
+      - 'main'
+    paths:
+      - 'Dockerfile'
+      - '.dockerignore'
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  docker:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+
+      - name: Login to Container Registry
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v2
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

.github/workflows/go.yml

@@ -0,0 +1,25 @@
+name: go
+
+on:
+  push:
+    tags:
+      - v*
+    branches:
+      - master
+      - main
+  pull_request:
+
+permissions:
+  contents: read
+  pull-requests: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-go@v5
+        with:
+          go-version: 1.24
+      - name: Test
+        run: go test -v ./...

.github/workflows/lint.yml

@@ -0,0 +1,33 @@
+name: lint
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+
+  golangci-lint:
+    name: golangci-lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '1.24'
+          cache: false
+      - name: golangci-lint
+        uses: golangci/golangci-lint-action@v8
+        with:
+          version: v2.4
+
+  conventional-commits:
+    name: conventional-commits
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: webiny/action-conventional-commits@v1.3.0

.github/workflows/release.yml

@@ -0,0 +1,31 @@
+name: release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+  # packages: write
+  # issues: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - run: git fetch --force --tags
+      - uses: actions/setup-go@v4
+        with:
+          go-version: stable
+
+      - uses: goreleaser/goreleaser-action@v4
+        with:
+          distribution: goreleaser
+          version: latest
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.golangci.yml

@@ -0,0 +1,25 @@
+version: '2'
+linters:
+  default: none
+  enable:
+    # defaults
+    - errcheck
+    - govet
+    - ineffassign
+    - staticcheck
+    - unused
+    # addons
+    - gocyclo
+    - revive
+    - whitespace
+    - wsl_v5
+  settings:
+    wsl_v5:
+      allow-first-in-block: true
+      allow-whole-block: false
+      branch-max-lines: 2
+    revive:
+      rules:
+        # this is not a library project
+        - name: exported
+          disabled: true

.goreleaser.yaml

@@ -0,0 +1,44 @@
+before:
+  hooks:
+    - go mod tidy
+    - go generate ./...
+builds:
+  - env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - windows
+      - darwin
+    flags:
+      - -trimpath
+
+archives:
+  - format: tar.gz
+    # this name template makes the OS and Arch compatible with the results of uname.
+    name_template: >-
+      {{ .ProjectName }}_
+      {{- title .Os }}_
+      {{- if eq .Arch "amd64" }}x86_64
+      {{- else if eq .Arch "386" }}i386
+      {{- else }}{{ .Arch }}{{ end }}
+      {{- if .Arm }}v{{ .Arm }}{{ end }}
+    # use zip for windows archives
+    format_overrides:
+    - goos: windows
+      format: zip
+
+checksum:
+  name_template: 'checksums.txt'
+snapshot:
+  name_template: "{{ incpatch .Version }}-next"
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - '^docs:'
+      - '^test:'
+      - '^ci:'
+      - '^nit:'
+
+# yaml-language-server: $schema=https://goreleaser.com/static/schema.json
+# vim: set ts=2 sw=2 tw=0 fo=cnqoj

cmd/linkding-mcp/main.go

@@ -31,6 +31,7 @@ func main() {
 	switch mode {
 	case "http":
 		fmt.Printf("Starting Linkding-MCP HTTP server on %s\n", bindAddr)
+
 		if err := mcpServer.RunHTTP(ctx, bindAddr); err != nil {
 			fmt.Fprintf(os.Stderr, "Error running MCP server: %v\n", err)
 			os.Exit(1)

internal/server/mcp.go

@@ -49,12 +49,15 @@ func (s *MCPServer) handleSearchBookmarks(ctx context.Context, req *mcpsdk.CallT
 	result := fmt.Sprintf("Found %d bookmarks:\n\n", len(bookmarks.Results))
 	for _, bookmark := range bookmarks.Results {
 		result += fmt.Sprintf("• **%s**\n  URL: %s\n", bookmark.Title, bookmark.URL)
+
 		if bookmark.Description != "" {
 			result += fmt.Sprintf("  Description: %s\n", bookmark.Description)
 		}
+
 		if len(bookmark.TagNames) > 0 {
 			result += fmt.Sprintf("  Tags: %v\n", bookmark.TagNames)
 		}
+
 		result += "\n"
 	}
 
@@ -100,9 +103,11 @@ func (s *MCPServer) handleCreateBookmark(ctx context.Context, req *mcpsdk.CallTo
 
 	result := fmt.Sprintf("✅ Bookmark created successfully!\n\n• **%s**\n  URL: %s\n  ID: %d",
 		bookmark.Title, bookmark.URL, bookmark.ID)
+
 	if bookmark.Description != "" {
 		result += fmt.Sprintf("\n  Description: %s", bookmark.Description)
 	}
+
 	if len(bookmark.TagNames) > 0 {
 		result += fmt.Sprintf("\n  Tags: %v", bookmark.TagNames)
 	}
@@ -200,5 +205,6 @@ func NewMCP(linkdingURL, apiToken string) *MCPServer {
 	}, s.handleGetTags)
 
 	s.mcpServer = mcpServer
+
 	return s
 }

internal/server/types.go

@@ -0,0 +1,37 @@
+package server
+
+// GetTagsArgs defines the input structure for get_tags tool
+type GetTagsArgs struct {
+	Limit int `json:"limit,omitempty" jsonschema:"description:Maximum number of tags to return,default:50"`
+}
+
+// CreateBookmarkArgs defines the input structure for create_bookmark tool
+type CreateBookmarkArgs struct {
+	URL         string   `json:"url" jsonschema:"description:URL to bookmark"`
+	Title       string   `json:"title,omitempty" jsonschema:"description:Bookmark title"`
+	Description string   `json:"description,omitempty" jsonschema:"description:Bookmark description"`
+	Tags        []string `json:"tags,omitempty" jsonschema:"description:List of tags"`
+}
+
+// SearchBookmarksArgs defines the input structure for search_bookmarks tool
+type SearchBookmarksArgs struct {
+	Query string `json:"query,omitempty" jsonschema:"description:Search query"`
+	Limit int    `json:"limit,omitempty" jsonschema:"description:Maximum number of results,default:20"`
+}
+
+// BookmarkResult defines the output structure for bookmark operations
+type BookmarkResult struct {
+	ID          int      `json:"id"`
+	URL         string   `json:"url"`
+	Title       string   `json:"title"`
+	Description string   `json:"description,omitempty"`
+	Tags        []string `json:"tags,omitempty"`
+	Success     bool     `json:"success"`
+	Message     string   `json:"message,omitempty"`
+}
+
+// TagResult defines the output structure for tag operations
+type TagResult struct {
+	ID   int    `json:"id"`
+	Name string `json:"name"`
+}