go-mcp-server-service

Name: go-mcp-server-service
Author: AndrewDonelson

@AndrewDonelson

Repository

About go-mcp-server-service

A JSON-RPC 2.0 compliant server implementing the Model Context Protocol (MCP) for note management (as an example)

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "go-mcp-server-service": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "./bin/dev/<platform>/notes-server"
      ]
    }
  }
}

Tools

Adds a new note to the server

Overview

What is go-mcp-server-service?

go-mcp-server-service is a JSON-RPC 2.0 compliant server implementing the Model Context Protocol (MCP) for note management. It serves as an example and boilerplate that you can modify for your own MCP server projects.

How to use go-mcp-server-service?

Build all components with make dev or make release-all, then run the command-line interface with make run-cmd or the service with make run-service. Configure Claude Desktop by adding the binary path to claude_desktop_config.json under the mcpServers section.

Key features of go-mcp-server-service

JSON-RPC 2.0 compliant API
Cross-platform support (Windows, Linux, macOS)
Thread-safe note management
Development and release build configurations
Command-line interface and service components
Custom note:// URI scheme for notes

Use cases of go-mcp-server-service

Manage notes via the MCP protocol in a local environment
Use as a boilerplate to build your own MCP server
Integrate with Claude Desktop for note‑based workflows
Experiment with thread‑safe resource and tool implementations

FAQ from go-mcp-server-service

What transport does go-mcp-server-service use?

The server runs over stdio.

What are the build dependencies?

Go 1.21 or later, GNU Make or a compatible build tool, and Git for version information.

How can I debug the server?

Use the MCP Inspector by running npx @modelcontextprotocol/inspector ./bin/dev/<platform>/notes-server.

What custom error codes are implemented?

Custom error codes include -32001 (Resource not found) and -32002 (Unsupported operation), in addition to standard JSON‑RPC error codes.

How do I configure Claude Desktop to use the server?

Add the binary path (e.g., ./bin/dev/<platform>/notes-server) and an empty arguments list to claude_desktop_config.json under mcpServers.

Comments

More Developer Tools MCP servers

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

2.8K

Sentry

modelcontextprotocol

Model Context Protocol Servers

88.1K

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K