Content
# mcp-tools
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
```json
{
"mcpServers": {
"github.com/fredrikaverpil/mcp-tools": {
"command": "go",
"args": [
"-C",
"/absolute/path/to/mcp-tools",
"run",
"./cmd/cmd-tools/main.go"
]
}
}
}
```
#### Non-local
```json
{
"mcpServers": {
"github.com/fredrikaverpil/mcp-tools": {
"command": "go",
"args": [
"run",
"github.com/fredrikaverpil/mcp-tools/cmd/cmd-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
```sh
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):
```json
{
"mcpServers": {
"github.com/fredrikaverpil/mcp-tools": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/mcp-tools", "run", "server.py"]
}
}
}
```
## References
- [MCP documentation](https://modelcontextprotocol.io)
- [MCP GitHub organization](https://github.com/modelcontextprotocol)
- [MCP servers](https://github.com/modelcontextprotocol/servers)
- [Unofficial Go implementation](https://github.com/mark3labs/mcp-go)
- [Official Python SDK](https://github.com/modelcontextprotocol/python-sdk)
Connection Info
You Might Also Like
MarkItDown MCP
Converting files and office documents to Markdown.
Time
Obtaining current time information and converting time between different...
Filesystem
Model Context Protocol Servers
Sequential Thinking
Offers a structured approach to dynamic and reflective problem-solving,...
Git
Model Context Protocol Servers
Context 7
Context7 MCP Server -- Up-to-date code documentation for LLMs and AI code editors