Wizelit MCP

Wizelit MCP服务器示例

FastMCP捆绑包公开了4个示例MCP服务器，用于测试Wizelit平台的多种传输模式。

代理（4个运输示例）

建筑

sample-mcp-servers/
├── mcp_servers/
│   ├── code-scout/           # Code Scout (SSE, port 1338)
│   │   ├── server.py
│   │   ├── scanner.py
│   │   ├── github_helper.py
│   │   └── github_cache.py
│   ├── refactoring-agent/    # Refactoring Crew (SSE, port 1337)
│   │   └── main.py
│   ├── schema-validator/     # Schema Validator (Streamable-HTTP, port 1340)
│   │   ├── main.py
│   │   └── validator.py
│   └── code-formatter/       # Code Formatter (Stdio)
│       ├── main.py
│       └── formatter.py
├── utils/
│   └── bedrock_config.py     # AWS Bedrock configuration
├── TRANSPORT_GUIDE.md        # 🆕 Transport modes explained
└── SETUP.md                  # Setup instructions

快速开始

1.安装依赖项

uv pip install -e .

2.配置环境

cp .env.template .env
# Edit .env with your AWS credentials

3.启动所有服务器

./start.sh

这将启动所有4个代理：

• 代码侦察员（SSE，：1338）
• 重构代理（SSE，：1337）
• 模式验证器（流式HTTP，1340）
• 代码格式化程序（Stdio）

4.或者单独开始

端子1 -代码侦察员（SSE）：

python mcp_servers/code-scout/server.py

2号航站楼 -重构代理（SSE）：

python mcp_servers/refactoring-agent/main.py

3号航站楼 -模式验证器（流式HTTP）：

python mcp_servers/schema-validator/main.py

4号航站楼 -代码格式化程序（Stdio）：

python mcp_servers/code-formatter/main.py

集成端点

• 重构代理SSE: http://127.0.0.1:1337/sse
• 代码侦察员SSE: http://127.0.0.1:1338/sse
• 模式验证器流式HTTP: http://127.0.0.1:1340/mcp （基于POST）
• 程序代码格式制作器：基于标准（基于过程）

重要：所有MCP服务器必须通过Chainlit UI手动添加-没有自动发现。有关每台服务器的详细配置说明，请参阅SETUP.md。

故障排除

端口已在使用中：运行 ./cleanup.sh 杀死任何过时的进程

./cleanup.sh

缺少依赖项：安装时使用：

uv pip install -e .

基岩身份验证错误：检查AWS环境变量：

echo $AWS_ACCESS_KEY_ID
echo $AWS_SECRET_ACCESS_KEY
echo $AWS_DEFAULT_REGION

Wizelit平台应连接到这些端点并发现可用的工具。

交通方式详解

看 交通指南.md 有关以下内容的详细信息：

• SSE（服务器发送事件） -长时间使用流媒体
• 流式HTTP -标准请求响应
• 工作室 -本地流程执行

环境变量

必需（仅适用于重构代理）

• AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY
• AWS_REGION （默认值： us-east-1)
• CHAT_MODEL_ID （默认值： anthropic.claude-3-haiku-20240307-v1:0)

可选的

• GITHUB_TOKEN：访问私有仓库（代码侦察员）
• REDIS_URL, ENABLE_LOG_STREAMING：日志流（重构代理）
• CREWAI_MODEL, CREWAI_TIMEOUT_SECONDS：CrewAI设置
• JOB_LOG_TAIL：要返回的日志行（默认值：25）

发展

# Install dependencies
make install

# Start all servers
make run

# Show individual server commands
make servers

# Format code
make format

# Clean cache
make clean

代理示例

模式验证器（快速，请求响应）

验证Python函数/类签名：

curl -X POST http://127.0.0.1:1340/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "method": "validate_function_signature",
    "params": {
      "code": "def greet(name: str) -> str: return f\"Hello, {name}!\"",
      "function_name": "greet",
      "expected_params": "[\"name\"]",
      "expected_return_type": "str"
    }
  }'

代码格式化程序（标准，本地）

格式化Python代码。 备注：所有服务器都必须通过Chainlit UI添加。代码格式化程序使用stdio传输，不能直接使用curl进行测试。

要使用：

1. 通过Chainlit UI添加所有服务器（详见SETUP.md）
2. 通过Wizelit平台界面使用工具

可用的代码格式化工具：

• format_code -应用黑色样式格式规则
• organize_imports -组织和整理进口报表
• normalize_indentation -规范缩进（默认值：4个空格）
• format_all -按顺序应用所有格式规则

故障排除

端口已在使用中

# Kill existing processes
./cleanup.sh

# Or manually
lsof -i:1337  # Find process
kill -9 

代理无法启动

# Check Python version
python --version  # Must be 3.10+

# Check dependencies
uv pip list | grep wizelit-sdk

# Run agent directly to see errors
python mcp_servers/schema-validator/main.py

平台无法连接

# Test HTTP endpoint
curl http://127.0.0.1:1340/mcp

# Check firewall
sudo lsof -i:1340

# Check logs
python -u mcp_servers/schema-validator/main.py  # With unbuffered output

关键文件

参考文献

• MCP协议
• 快速MCP
• Wizelit SDK
• 运输比较

许可证

\[在此处添加您的许可证\]