Skip to content

docs: Claude Desktop MCP設定にWSL2パターンを追加 (FT3-F3) #87

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hideyukiMORI merged 1 commit into from
May 19, 2026
Merged

docs: Claude Desktop MCP設定にWSL2パターンを追加 (FT3-F3) #87

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 50 additions & 1 deletion docs/howto/mcp-setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,14 @@ Once configured, Claude Desktop and the `claude` CLI can perform CRUD operations

## Claude Desktop configuration

Add the following to `claude_desktop_config.json`:
`claude_desktop_config.json` is located at:

| OS | Path |
|---|---|
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |

### macOS / Linux (native)

```json
{
Expand All @@ -38,6 +45,48 @@ Add the following to `claude_desktop_config.json`:

Replace `/path/to/nene2-python` with the absolute path to this repository.

### Windows + WSL2

Claude Desktop runs on Windows but the project lives inside WSL2.
Use `wsl` as the command to bridge them:

```json
{
"mcpServers": {
"nene2-example": {
"command": "wsl",
"args": [
"-e", "bash", "-c",
"cd /home/<user>/nene2-python && PYTHONPATH=src uv run python -m example.mcp"
],
"env": {
"DB_ADAPTER": "sqlite",
"DB_NAME": "/home/<user>/nene2-python/data/nene2.db"
}
}
}
}
```

> All paths must be **WSL Linux paths** (e.g. `/home/user/...`), not Windows paths.
> The `DB_NAME` must also be a Linux path so SQLite creates the file inside WSL.

For a project installed via `uv add git+...` (not the nene2-python repo itself):

```json
{
"mcpServers": {
"myapp": {
"command": "wsl",
"args": [
"-e", "bash", "-c",
"cd /home/<user>/my-project && PYTHONPATH=src uv run python -m mcp_server"
]
}
}
}
```

## Available tools

| Tool | Description |
Expand Down
51 changes: 50 additions & 1 deletion docs/ja/howto/mcp-setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,14 @@ Claude Desktop や `claude` CLI から直接 CRUD 操作が可能になります

## Claude Desktop への設定

`claude_desktop_config.json` に以下を追加します:
`claude_desktop_config.json` のパス:

| OS | パス |
|---|---|
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |

### macOS / Linux（ネイティブ）

```json
{
Expand All @@ -38,6 +45,48 @@ Claude Desktop や `claude` CLI から直接 CRUD 操作が可能になります

`/path/to/nene2-python` をリポジトリの絶対パスに変更してください。

### Windows + WSL2

Claude Desktop は Windows で動作しますが、プロジェクトは WSL2 内にあります。
`wsl` コマンドでブリッジします:

```json
{
"mcpServers": {
"nene2-example": {
"command": "wsl",
"args": [
"-e", "bash", "-c",
"cd /home/<user>/nene2-python && PYTHONPATH=src uv run python -m example.mcp"
],
"env": {
"DB_ADAPTER": "sqlite",
"DB_NAME": "/home/<user>/nene2-python/data/nene2.db"
}
}
}
}
```

> パスはすべて **WSL の Linux パス**（例: `/home/user/...`）で指定します。
> `DB_NAME` も Linux パスにすることで、SQLite ファイルが WSL 内に作成されます。

`uv add git+...` でインストールした外部プロジェクトの場合:

```json
{
"mcpServers": {
"myapp": {
"command": "wsl",
"args": [
"-e", "bash", "-c",
"cd /home/<user>/my-project && PYTHONPATH=src uv run python -m mcp_server"
]
}
}
}
```

## 利用可能なツール

| ツール | 説明 |
Expand Down
Loading