mcp-tools

April 22, 2025 ยท View on GitHub

This repo serves as a demo on how to define your own MCP servers using Go or Python.

Quickstart

MCP servers JSON paths

  • ~/Library/Application Support/Claude/claude_desktop_config.json
  • ~/.cursor/mcp.json

Go

Run neovim/claude desktop/vscode/cursor from a shell which has the go binary on $PATH.

Local

{
  "mcpServers": {
    "github.com/fredrikaverpil/mcp-tools": {
      "command": "go",
      "args": [
        "-C",
        "/absolute/path/to/mcp-tools",
        "run",
        "./cmd/mcp-tools/main.go"
      ]
    }
  }
}

Non-local

{
  "mcpServers": {
    "github.com/fredrikaverpil/mcp-tools": {
      "command": "go",
      "args": [
        "run",
        "github.com/fredrikaverpil/mcp-tools/cmd/mcp-tools@latest"
      ]
    }
  }
}

Python

Run neovim/claude desktop/vscode/cursor from a shell which has the uv binary on $PATH and the required dependencies specified in the pyproject.toml.

Local

cd mcp-tools

# install uv (if not already available), macOS example
brew install uv

# install dependencies
uv sync

Add to the MCP server JSON settings (path depends on which app you're using):

{
  "mcpServers": {
    "github.com/fredrikaverpil/mcp-tools": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/mcp-tools", "run", "server.py"]
    }
  }
}

References