AI导哈

MCP服务器

一个支持STDIO和HTTP传输模式的MCP服务器，适用于Claude Desktop、Web应用和云部署。

  • by ZDPS121
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 FadilAmiruddin/MCP

使用说明

我的超酷服务器

使用（某技术/工具）构建的MCP服务器 ChukMCPServer（这个名称可能是特定软件或系统中的一个服务器名称，直接翻译为中文可能无法准确传达其含义，但可大致译为）：楚克MCP服务器。

运输方式

此服务器支持两种传输模式：

  • **STDIO（默认）**适用于 Claude Desktop 和 MCP 客户端。通过标准输入/输出进行通信。
  • **HTTP（超文本传输协议）**适用于Web应用、API和云部署。支持流传输的RESTful终端点。

快速入门

选项1：Claude桌面版（STDIO模式）

1. 安装依赖项

# Install globally
uv pip install --system chuk-mcp-server

# Or in a virtual environment (recommended)
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install chuk-mcp-server

2. 测试服务器

# Default mode is stdio - perfect for Claude Desktop
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | python server.py

3. 配置Claude桌面版

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "my-awesome-server": {
      "command": "uv",
      "args": ["--directory", "/Users/fadilamiruddin/my-awesome-server", "run", "server.py"]
    }
  }
}

重启 Claude 桌面应用，您的服务器即可使用！

选项2：Web/API（HTTP模式）

非常适合网络应用和云部署。

# Start HTTP server on port 8000
python server.py --http

# Or specify custom port/host
python server.py --port 8000 --host 0.0.0.0

使用curl进行测试：

curl http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

选项3：Docker（生产环境部署）

Docker 会自动以 HTTP 模式运行服务器，非常适合生产环境部署。

使用 docker-compose（最简单的方法）

docker-compose up

或者手动构建

# Build the image
docker build -t my-awesome-server .

# Run the container
docker run -p 8000:8000 my-awesome-server

测试部署

curl http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

你应该看到：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {"name": "hello", "description": "Say hello to someone."},
      {"name": "add_numbers", "description": "Add two numbers together."},
      {"name": "calculate", "description": "Safely evaluate a mathematical expression."}
    ]
  }
}

非常适合部署到AWS、GCP、Azure或Kubernetes等云平台！

可用工具

  • 你好跟某人打个招呼
  • 加数字把两个数相加
  • 计算安全地评估一个数学表达式

可用资源

  • 配置://信息获取服务器信息

发展

运行测试

uv run pytest

类型检查

uv run mypy server.py

代码检查（或代码格式化）

uv run ruff check .

命令行选项

服务器会自动检测最佳传输模式，但您可以手动覆盖该设置：

# Force STDIO mode (default)
python server.py --stdio
python server.py --transport=stdio

# Force HTTP mode
python server.py --http
python server.py --port 8000
python server.py --host 0.0.0.0
python server.py --transport=http

定制化

编辑 server.py 添加您自己的工具和资源：

from chuk_mcp_server import tool, resource, run

@tool
def my_custom_tool(param: str) -> str:
    """Your custom tool description."""
    return f"Result: {param}"

@resource("custom://data")
def my_resource() -> dict:
    """Your custom resource."""
    return {"data": "value"}

if __name__ == "__main__":
    run(transport="stdio")  # or just run() for auto-detection

查看 ChukMCPServer 文档 以获取更多示例和高级功能。

MCP

相关 MCP