MCP μλ² μ°λ μ€λ₯μ μ€ν¨
ν΄λ‘λ λ°μ€ν¬ν(Claude Desktop)μ MCP μλ²λ€μ μ°κ²°ν΄λ³΄λ©΄μ κ²½ννλ μ€λ₯μ ν΄κ²° λ°©λ²μ λν΄μ 곡μ νλ €κ³ ν©λλ€. μλ‘ λ€λ₯Έ μ»΄ν¨ν° νκ²½μΌλ‘ μΈν΄ μκ°λ³΄λ€ λ§μ μ¬λλ€μ΄ μλμΉμκ² μ½μ§
μ νκ³ μλ κ² κ°μ΅λλ€. μμ§μ MCP μλ²λ€μ΄ μμ±λ μκ² μμ±λλ μνλ μλλ―λ‘ μ€λ₯μ μ€ν¨μ λν κ²½νμ΄ λ μ€μ
νμ§ μμκΉ μΆμ΅λλ€.
μ΄μ체μ λ³ λ Έλ λ° νμ΄μ¬ ν¨ν€μ§ λ§€λμ λ‘ μΈν μ€λ₯
command not found: /Users/username/Desktop
μ€νΈλ‘ν½μ΄ κΈ°λ³Έμ μΌλ‘ μ 곡νλ Filesystem MCP Serverλ TypeScript MCP SDKλ‘ μμ±λ κ°μ₯ κΈ°λ³Έμ μΈ MCP μλ²μ
λλ€. νμ§λ§, λ
Έλλ₯Ό nvm κ³Ό κ°μ ν¨ν€μ§ κ΄λ¦¬ λκ΅¬λ‘ μ€μΉνλ€λ©΄ μ¬λ°λ₯΄κ² μ€νλμ§ μλ μν©μ λ§λ μ μμ΅λλ€. μ΄ λ¬Έμ κ° λ°μν κ²½μ° ν΄λ‘λ λ°μ€ν¬νμ΄ λ°λΌλ³΄λ npx μ μ 체 κ²½λ‘λ₯Ό λͺ
μνλκ² ν΄κ²°μ±
μ΄μ§λ§ servers#64 μ΄μμ λκΈμ²λΌ ν΄λ‘λ λ°μ€ν¬νμ μν μ μ€ν¬λ¦½νΈλ₯Ό λ§λ€μ΄μ μ¬μ©ν΄λ λ©λλ€.
$ sudo vi /usr/local/bin/npx-for-claude
---
#!/usr/bin/env bash
export PATH="/Users/username/.nvm/versions/node/v22.14.0/bin:$PATH"
exec npx "$@"
---
$ sudo chmod +x /usr/local/bin/npx-for-claude
{
"mcpServers": {
"filesystem": {
"command": "npx-for-claude",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop"
]
}
}
}
spawn uvx ENOENT2025-04-09T04:55:27.164Z [time] [info] Initializing server... 2025-04-09T04:55:27.186Z [time] [error] spawn uvx ENOENT {"context":"connection","stack":"Error: spawn uvx ENOENT\n at ChildProcess._handle.onexit (node:internal/child_process:285:19)\n at onErrorNT (node:internal/child_process:483:16)\n at process.processTicksAndRejections (node:internal/process/task_queues:82:21)"} 2025-04-09T04:55:27.187Z [time] [error] spawn uvx ENOENT {"stack":"Error: spawn uvx ENOENT\n at ChildProcess._handle.onexit (node:internal/child_process:285:19)\n at onErrorNT (node:internal/child_process:483:16)\n at process.processTicksAndRejections (node:internal/process/task_queues:82:21)"} 2025-04-09T04:55:27.188Z [time] [info] Server transport closed 2025-04-09T04:55:27.188Z [time] [info] Client transport closed 2025-04-09T04:55:27.189Z [time] [info] Server transport closed unexpectedly, this is likely due to the process exiting early. If you are developing this MCP server you can add output to stderr (i.e. `console.error('...')` in JavaScript, `print('...', file=sys.stderr)` in python) and it will appear in this log. 2025-04-09T04:55:27.189Z [time] [error] Server disconnected. For troubleshooting guidance, please visit our [debugging documentation](https://modelcontextprotocol.io/docs/tools/debugging) {"context":"connection"}
Python MCP SDKλ‘ μμ±λλ MCP μλ²λ€μ λ§₯ νκ²½μμ uvx λ‘ μ€ννκΈ° μν΄ uv λ₯Ό μ€μΉν κ²½μ°μλ λμΌν©λλ€. μ μ€ν¬λ¦½νΈ κΈ°λ°μΌλ‘ μ€μΉνλ κ²½μ° /usr/.local/bin κ²½λ‘μ μ€μΉλλλ° ν΄λ‘λ λ°μ€ν¬νμμ μ¬μ©λλ κ²½λ‘κ° μλλλ€. μ΄ κ²½μ°μλ μ 체 κ²½λ‘λ₯Ό λͺ μνκ±°λ Homebrewλ‘ μ€μΉνλ©΄ ν΄λ‘λ λ°μ€ν¬νμ΄ λ°λΌλ³΄λ κ²½λ‘μ μ λλ‘ μ€μΉλ©λλ€.
Google Drive MCP μμ λ컀 컨ν μ΄λλ‘ μΈμ¦ν μ μλ λ¬Έμ
servers#1289 μ΄μμ κ°μ΄ Google Drive MCP μλ²λ₯Ό μ¬μ©νκΈ° μν΄ κ΅¬κΈ OAuth2 μ¬μ©μ μ 보λ₯Ό ν΅ν΄ ν¬λ λ΄μ μ λ°κΈνλ €κ³ ν λ @google-cloud/local-authμμ λλ€ ν¬νΈλ‘ μ€νλμ΄ READMEμ κΈ°μ¬λ λ΄μ©κ³Ό λ€λ₯΄κ² μΈμ¦ κ²°κ³Όκ° μ μμ μΌλ‘ 리λ€μ΄λ νΈλ μ μλ λ¬Έμ κ° μμ΅λλ€.
OAuth ν΄λΌμ΄μΈνΈ μμ΄λλ₯Ό λ§λ€λ Desktop App μ νμΌλ‘ λ§λ€λ©΄ installed λ₯Ό ν€λ‘ κ°μ§λ JSON νμΌμ λ€μ΄λ‘λνκ² λ©λλ€. λ°λΌμ, κ°μ΄λμ κΈ°μ¬λ λͺ λ Ήμ΄λλ‘ 3000 ν¬νΈλ‘ μμ νκΈ° μν΄μλ web μΌλ‘ λ³κ²½νκ³ μ€νν΄μΌν©λλ€.
{
"web": {
"client_id": "YOUR_CLIENT_ID",
"project_id": "YOUR_PROJECT_ID",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_secret": "YOUR_CLIENT_SECRET",
"redirect_uris": ["http://localhost"]
}
}
Redis MCPκ° μ»€μ μ±μμ μ΄λ¦¬λ λ¬Έμ
μλμ° νκ²½μμ ν΄λ‘λ λ°μ€ν¬νμ΄ Redis MCP Serverλ₯Ό μ€ννμ λ index.js νμΌμ΄ 컀μ μ±μΌλ‘ μ€νλλ μ¦μμ κ²½ννμ΅λλ€. Redis MCP μλ² μ€μ μ λ€μκ³Ό κ°μ΄ λ³λ€λ₯Έ λΆλΆμ΄ μλ μνμ λλ€.
{
"mcpServers": {
"redis": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-redis", "redis://localhost:6379"]
}
}
2025-04-10T12:45:00.248Z [redis] [info] Initializing server...
2025-04-10T12:45:00.487Z [redis] [info] Server started and connected successfully
2025-04-10T12:45:00.604Z [redis] [info] Message from client: {"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}
2025-04-10T12:45:43.369Z [redis] [info] Server transport closed
2025-04-10T12:45:43.369Z [redis] [info] Client transport closed
2025-04-10T12:45:43.369Z [redis] [info] Server transport closed unexpectedly, this is likely due to the process exiting early. If you are developing this MCP server you can add output to stderr (i.e. `console.error('...')` in JavaScript, `print('...', file=sys.stderr)` in python) and it will appear in this log.
2025-04-10T12:45:43.370Z [redis] [error] Server disconnected. For troubleshooting guidance, please visit our [debugging documentation](https://modelcontextprotocol.io/docs/tools/debugging) {"context":"connection"}
2025-04-10T12:45:43.371Z [redis] [info] Client transport closed
μ€νΈλ‘ν½μ΄ μ 곡ν MCP λμ μ GongRzhe/REDIS-MCP-Serverλ₯Ό μ¬μ©νμλλ λ°μνμ§ μμλλ° νμ μ€ν¬λ¦½νΈ SDKλ‘ μμ±λ λ€λ₯Έ MCP μλ²λ€μ μ΄ν΄λ³Έ κ²°κ³Ό, λ Έλμ λν Shebangμ΄ μλ΅λμ΄ μμ΅λλ€λ§ μ΄κ²μ΄ μμΈμΌμ§λ μ λͺ¨λ₯΄κ² μΌλ μ΄μλ‘ λ±λ‘ν΄λμ μνμ λλ€.
Redis MCP μμ λΉλ°λ²νΈ μΈμ¦μ΄ νμν κ²½μ°
Redis MCP Serverμ README νμΌμλ λ‘컬μ μ€νν λ λμ€μ μ°κ²°νλ μμλ‘ μλ΄ν΄μ£Όκ³ μμ΅λλ€. λ§μ½, requirepass μ΅μ μ΄ μ μ©λ λ λμ€μ μ°κ²°νλ €λ©΄ URLμ λΉλ°λ²νΈκ° ν¬ν¨λ ννλ‘ μ€μ ν΄μΌν©λλ€.
docker run --name redis -d -p 6379:6379 redis redis-server --requirepass 1234
{
"mcpServers": {
"redis": {
"command": "npx",
"args": ["-y", "@gongrzhe/server-redis-mcp@1.0.0", "redis://:1234@localhost:6379"]
}
}
}
Github MCP μμ μ‘°μ§ λ¦¬νμ§ν 리 κΆνμ΄ μμ
github-mcp-server#153μ²λΌ Github MCP μλ²λ₯Ό μν μ‘μΈμ€ ν ν°μ λ°κΈν λ Fine-grained PAT
λ‘ λ°κΈνλ©΄ μ‘°μ§ κ³μ μ 리νμ§ν 리λ₯Ό μ‘°νν μ μλ κΆνμ΄ μλ λ¬Έμ κ° μμ΅λλ€. λ°λΌμ, ν΄λμ(classic) ν ν°μΌλ‘ λ°κΈλ°μμ μ¬μ©νλ κ²μ κΆμ₯ν©λλ€.
Time MCP: No time zone found with key KST
Traceback (most recent call last):
File "/Users/username/Library/Application Support/uv/python/cpython-3.12.9-macos-aarch64-none/lib/python3.12/zoneinfo/_common.py", line 12, in load_tzdata
return resources.files(package_name).joinpath(resource_name).open("rb")
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/Users/username/Library/Application Support/uv/python/cpython-3.12.9-macos-aarch64-none/lib/python3.12/pathlib.py", line 1013, in open
return io.open(self, mode, buffering, encoding, errors, newline)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
FileNotFoundError: [Errno 2] No such file or directory: '/Users/username/.cache/uv/archive-v0/S2oZOdPKchj5YFK67-25o/lib/python3.12/site-packages/tzdata/zoneinfo/KST'
During handling of the above exception, another exception occurred:
Traceback (most recent call last):
File "/Users/username/.cache/uv/archive-v0/S2oZOdPKchj5YFK67-25o/bin/mcp-server-time", line 12, in <module>
sys.exit(main())
^^^^^^
File "/Users/username/.cache/uv/archive-v0/S2oZOdPKchj5YFK67-25o/lib/python3.12/site-packages/mcp_server_time/__init__.py", line 15, in main
asyncio.run(serve(args.local_timezone))
File "/Users/username/Library/Application Support/uv/python/cpython-3.12.9-macos-aarch64-none/lib/python3.12/asyncio/runners.py", line 195, in run
return runner.run(main)
^^^^^^^^^^^^^^^^
File "/Users/username/Library/Application Support/uv/python/cpython-3.12.9-macos-aarch64-none/lib/python3.12/asyncio/runners.py", line 118, in run
return self._loop.run_until_complete(task)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/Users/username/Library/Application Support/uv/python/cpython-3.12.9-macos-aarch64-none/lib/python3.12/asyncio/base_events.py", line 691, in run_until_complete
return future.result()
^^^^^^^^^^^^^^^
File "/Users/username/.cache/uv/archive-v0/S2oZOdPKchj5YFK67-25o/lib/python3.12/site-packages/mcp_server_time/server.py", line 119, in serve
local_tz = str(get_local_tz(local_timezone))
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/Users/username/.cache/uv/archive-v0/S2oZOdPKchj5YFK67-25o/lib/python3.12/site-packages/mcp_server_time/server.py", line 45, in get_local_tz
return ZoneInfo(str(tzinfo))
^^^^^^^^^^^^^^^^^^^^^
File "/Users/username/Library/Application Support/uv/python/cpython-3.12.9-macos-aarch64-none/lib/python3.12/zoneinfo/_common.py", line 24, in load_tzdata
raise ZoneInfoNotFoundError(f"No time zone found with key {key}")
zoneinfo._common.ZoneInfoNotFoundError: 'No time zone found with key KST'
2025-04-10T02:15:25.495Z [time] [info] Server transport closed
2025-04-10T02:15:25.495Z [time] [info] Client transport closed
2025-04-10T02:15:25.495Z [time] [info] Server transport closed unexpectedly, this is likely due to the process exiting early. If you are developing this MCP server you can add output to stderr (i.e. `console.error('...')` in JavaScript, `print('...', file=sys.stderr)` in python) and it will appear in this log.
2025-04-10T02:15:25.495Z [time] [error] Server disconnected. For troubleshooting guidance, please visit our [debugging documentation](https://modelcontextprotocol.io/docs/tools/debugging) {"context":"connection"}
Time MCP Serverλ₯Ό μ€μ ν λ νμμ‘΄ μ΅μ
μ μ§μ νμ§ μμΌλ©΄ μλμΌλ‘ μμ€ν
νμμ‘΄
μ μ¬μ©ν©λλ€. νμ§λ§, IANA νμμ‘΄ νκΈ°κ° μλ κ²½μ° μμ κ°μ μ€λ₯κ° λ°μνκΈ° λλ¬Έμ κ°μ΄λ λ¬Έμμμλ μ ν μ΅μ
μ΄μ§λ§ --local-timezone μ΅μ
μ μ§μ
νλ κ²μ κΆμ₯νλ λ°μ
λλ€.
{
"mcpServers": {
"time": {
"command": "uvx",
"args": ["mcp-server-time", "--local-timezone=Asia/Seoul"]
}
}
}
MCP μλ² μ€μ μ κ³ μνλ λ§μ λΆλ€μκ² λμμ΄ λκΈΈ λ°λλλ€. κ°μ¬ν©λλ€.