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
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
servers
Model Context Protocol Servers
everything-claude-code
Complete Claude Code configuration collection - agents, skills, hooks,...
Time
A Model Context Protocol server for time and timezone conversions.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
Sequential Thinking
A structured MCP server for dynamic problem-solving and reflective thinking.