README.md•2.02 kB
# bun-fun
Simple local stdio MCP server example compiled with Bun
## Install dependencies
```
bun install
```
## Build executable
```
bun run build
```
## Add to Claude Desktop
Executable:
```json
{
...
"mcpServers": {
"example-mcp-server": {
"command": "<path-to-executable>"
}
}
}
```
Development:
```json
{
...
"mcpServers": {
"example-mcp-server-dev": {
"command": "bun",
"args": ["run", "<path-to-index.ts>"]
}
}
}
```
### Windows
- Config: `%APPDATA%\Claude\claude_desktop_config.json`
- Executable: `C:\\path\\to\\bun-fun\\mcp-server.exe`
- Development: `C:\\path\\to\\bun-fun\\index.ts`
### macOS
- Config: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Executable: `/path/to/bun-fun/mcp-server`
- Development: `/path/to/bun-fun/index.ts`
## Add to Claude Code
### CLI
Executable:
```bash
claude mcp add example-mcp-server "<path-to-executable>"
```
Development:
```bash
claude mcp add example-mcp-server-dev "bun" --args "run" "<path-to-index.ts>"
```
#### Windows
- Executable: `C:\\path\\to\\bun-fun\\mcp-server.exe`
- Development: `C:\\path\\to\\bun-fun\\index.ts`
#### macOS/Linux
- Executable: `/path/to/bun-fun/mcp-server`
- Development: `/path/to/bun-fun/index.ts`
### From Claude Desktop
> [!NOTE]
> macOS and WSL only.
```
claude mcp add-from-claude-desktop
```
## To-do
- [ ] IDE examples
## Available MCP Tools
This server provides the following MCP tools:
### `get_current_time`
Returns the current time in ISO format.
**Parameters:** None
**Example response:** `2025-09-20T15:30:45.123Z`
### `echo`
Echoes back the provided message.
**Parameters:**
- `message` (string, required): The message to echo back
**Example:**
- Input: `{ "message": "Hello, world!" }`
- Output: `Echo: Hello, world!`
### `add_numbers`
Adds two numbers together.
**Parameters:**
- `a` (number, required): First number
- `b` (number, required): Second number
**Example:**
- Input: `{ "a": 5, "b": 3 }`
- Output: `5 + 3 = 8`