概览
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.
