TW MCP本地服务器-Claude 4.6混合云计算
与Claude Sonnet 4.6集成的全面Python MCP(模型上下文协议)服务器实现,具有以下特点 混合云计算 它优先考虑本地执行,同时与Azure云资源无缝集成以完成资源密集型任务。
🌟 主要特点
🔥 混合云架构
- 本地优先计算:智能资源管理优先考虑本地执行
- Azure云集成:无缝回退到Azure Functions以完成要求苛刻的任务
- Windows桌面优化:专为高性能Windows工作站量身定制
- 资源意识决策:实时监控和智能任务分配
🧠 人工智能辅助
- 氛围编程:深思熟虑、富有同理心的编程伙伴
- 深度推理:建议背后有明确“为什么”的全面解释
- 支持性指导:鼓励患者提供帮助,建立信心
- 情商:识别并响应用户情绪状态
🎯 综合MCP模块
🧠 思维与工艺
- 头脑风暴:由意图或情绪引发的同情想法生成
- 思维导图:具有可视化映射和清晰度的递归概念分支
- 视角转换:在支持下重新定义问题和挑战默认值
- 创造力激增:通过发散思维打破创意僵局
🎨 视觉和图像生成
- 图像种子:主题视觉输出生成
- 调色板生成器:情感和品牌驱动的配色方案
- 着色模式:多种渲染技术(照片、素描、超现实)
- 流程草图:从最少的输入中起草视觉序列
🎬 动画与运动设计
- 运动品牌:标志和标语动画与品牌能量同步
- 振动衰减:情绪驱动的环境视觉体验过渡
- 循环工艺:无缝循环动画生成
- 温度同步:动画与环境输入(音乐、语音)同步
🧪 模型交互与测试
- LLM听写:语音到模型转录和听写工作流程
- API试验台:用于测试和验证API行为的本地沙箱
- 查询优化:快速调整语言以获得最佳清晰度和结果
- Weave探员:具有协调逻辑的多代理工作流编排
✍️ 写作与作文
- 写作缪斯:故事情节、品牌文案和种子概念文章
- 构图雕塑:写作任务的形式、语气和流程控制
- 编辑通行证:使用预设样式重写和润色文本
- 人物角色作家:基于字符的书写语音模拟
🎧 音乐和音频开发
- 音调生成器:与品牌情感和场景背景相关的旋律创意
- Beat Vibe:循环创建与动画和触发器同步
- 声景:多层环境音频设计生成
- 语音流:声音输入/输出处理和样式
🗣️ 语音识别与交互
- 语音捕捉:具有智能标签的上下文语音捕获
- 意图回声:语音中嵌入的语调和情感分析
- 演讲技巧:自然口语反应生成
- 命令流:语音激活MCP任务执行
🏗️ 建筑
混合计算决策引擎
┌─────────────────────────────────────────────────────────────┐
│ FastAPI Application │
├─────────────────────────────────────────────────────────────┤
│ Hybrid Compute Manager │
│ ┌─────────────────────┐ ┌─────────────────────────────┐ │
│ │ Local Execution │ │ Azure Cloud Functions │ │
│ │ - CPU Monitoring │ │ - Flex Consumption Plan │ │
│ │ - Memory Tracking │ │ - Serverless Compute │ │
│ │ - GPU Utilization │ │ - Auto-scaling │ │
│ └─────────────────────┘ └─────────────────────────────┘ │
├─────────────────────────────────────────────────────────────┤
│ MCP Plugin System │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │
│ │ Ideation │ │ Visual │ │ Voice & Audio │ │
│ │ Modules │ │ Generation │ │ Modules │ │
│ └──────────────┘ └──────────────┘ └──────────────────────┘ │
├─────────────────────────────────────────────────────────────┤
│ Claude Client │
├─────────────────────────────────────────────────────────────┤
│ Configuration Layer │
├─────────────────────────────────────────────────────────────┤
│ Azure Integration & Local Processing │
└─────────────────────────────────────────────────────────────┘资源管理战略
- 本地执行标准:CPU\ PluginMetadata:
return PluginMetadata( name="my_plugin", version="1.0.0", description="My custom plugin", author="Your Name" )
async def initialize(self) -> None: # Plugin initialization pass
async def shutdown(self) -> None: # Plugin cleanup pass
### 内置插件
- **Vibe编码器**:富有同情心的编程协助
- **代码分析器**:代码审查和改进建议
- **文档生成器**:自动生成文档
## ⚙️ 配置
使用环境变量或 `.env` 文件:
Server Configuration
HOST=localhost PORT=8000 DEBUG=false
Claude API Configuration
ANTHROPIC_API_KEY=your-api-key-here CLAUDE_MODEL=claude-sonnet-4-6 MAX_TOKENS=4096 TEMPERATURE=0.7
Plugin Configuration
ENABLED_PLUGINS=["vibe_coder"]
Security
SECRET_KEY=your-secret-key CORS_ORIGINS=["http://localhost:3000"]
Rate Limiting
RATE_LIMIT_REQUESTS=100 RATE_LIMIT_WINDOW=60
## 🖥️ Windows服务安装
对于Windows用户,服务器可以作为Windows服务安装:
1. **安装NSSM** (非吸吮服务经理):
下载自 [nssm.cc](https://nssm.cc/download)
1. **运行服务安装程序**:
python scripts/windows_service.py
1. **或者使用批处理文件**:
scripts\install_service.bat
1. **管理服务**:
.\scripts\manage_service.ps1 start .\scripts\manage_service.ps1 stop .\scripts\manage_service.ps1 status
## 🏗️ 部署选项
### 本地Windows桌面
Install as Windows service
python scripts/windows_service.py install python scripts/windows_service.py start
Or run directly
mcp-server run --host localhost --port 8000
### 混合云部署
Deploy Azure Functions
./scripts/deploy_azure_functions.sh
Configure hybrid settings
export AZURE_ENABLED=true export AZURE_SUBSCRIPTION_ID=your-subscription-id
Start with hybrid computing
mcp-server run --hybrid-enabled
### Docker部署
FROM python:3.11-slim
WORKDIR /app COPY . . RUN pip install -e .
EXPOSE 8000 CMD ["mcp-server", "run", "--host", "0.0.0.0"]
## 📊 性能与监控
### 资源监控
- **实时度量**:CPU、内存、磁盘、GPU利用率
- **历史分析**:业绩趋势和模式
- **阈值警报**:主动资源管理
- **成本跟踪**:Azure使用和成本优化
### 系统健康
- **健康终点**: `/health`, `/system/status`
- **插件状态**:单个模块健康检查
- **Azure集成**:服务可用性和延迟
- **性能指标**:响应时间和吞吐量
## 🔐 安全与隐私
### 本地安全
- **速率限制**:可配置的请求限制
- **CORS保护**:跨源请求管理
- **输入验证**:全面的请求净化
- **安全默认值**:生产就绪安全配置
### Azure安全
- **OAuth2集成**:安全云身份验证
- **管理身份**:无密码Azure访问
- **网络安全**:VPC和防火墙配置
- **审计日志**:全面的安全监控
## 📚 文档
- **[混合动力配置指南](HYBRID_CONFIGURATION.md)**:完成设置和配置
- **[API 文档](docs/api.md)**:API综合参考
- **[插件开发](docs/plugins.md)**:创建自定义MCP模块
- **[Azure集成](docs/azure.md)**:云部署指南
- **[Windows服务](docs/windows.md)**:桌面服务设置
## 🧪 测试与验证
### 自动化测试
Run all tests
pytest tests/
Test hybrid computing
python tests/test_integration.py
Test individual modules
pytest tests/test_brainstorm.py pytest tests/test_mindmap.py
### 手动测试
Test brainstorming
mcp-server vibe "Help me brainstorm ideas for..."
Test mindmapping
curl -X POST localhost:8000/mindmap/create -d '{"central_concept": "AI"}'
Test system status
curl localhost:8000/system/status
## 🤝 贡献
### 开发设置
Clone and setup
git clone https://github.com/AplUSAndmINUS/tw-mcp-local-server-claude.git cd tw-mcp-local-server-claude pip install -e ".[dev]"
Run tests
pytest
Format code
black src/ isort src/
### 插件开发
创建自定义MCP插件:
from mcp_server.plugins import PluginInterface, PluginMetadata
class MyPlugin(PluginInterface): def get_metadata(self) -> PluginMetadata: return PluginMetadata( name="my_plugin", version="1.0.0", description="Custom empathetic plugin", author="Your Name" )
async def initialize(self) -> None: # Initialize with empathy and support pass
## 🛡️ 安全特性
- **速率限制**:可配置的请求速率限制
- **CORS保护**:可配置的CORS源
- **输入验证**:基于Pydantic的请求验证
- **错误处理**:全面的错误处理和记录
- **API密钥安全**:安全的API密钥管理
- **Azure安全**:OAuth2和托管身份集成
## 📝 记录和监控
服务器使用具有移情上下文的结构化日志记录:
import structlog logger = structlog.get_logger()
Empathetic logging with user context
logger.info("Supporting user through creative challenge", user_mood="frustrated", assistance_type="brainstorming")
## 🌐 云集成
### Azure 函数
- **构思功能**:头脑风暴和思维导图
- **视觉功能**:图像和动画生成
- **音频功能**:音乐和语音处理
- **编排**:复杂的工作流管理
### 成本优化
- **本地优先**:本地执行的云成本为零
- **智能路由**:考虑成本的任务安排
- **使用情况监控**:实时成本跟踪
- **预算控制**:可配置的支出限额
## 📚 示例
这 `examples/` 目录包含:
- `vibe_coding_example.py`:完整的vibe编码演示
- `sample_mcp_config.py`:插件配置示例
- `usage_examples.json`:API使用示例
- `custom_plugin_template.py`:用于创建自定义插件的模板
运行vibe编码示例:
cd examples python vibe_coding_example.py
## 🧪 发展
### 设置开发环境
Install development dependencies
pip install -e ".[dev]"
Install pre-commit hooks
pre-commit install
Run tests
pytest
Format code
black src/ isort src/
Type checking
mypy src/
### 创建插件
1. 在中创建一个新的Python文件 `src/mcp_server/plugins/`
1. 扩展 `PluginInterface`
1. 实施所需方法
1. 增添 `ENABLED_PLUGINS` 配置
1. 重新启动服务器
## 🌐 云部署
### Docker部署
FROM python:3.9-slim
WORKDIR /app COPY . . RUN pip install -e .
EXPOSE 8000 CMD ["mcp-server", "run", "--host", "0.0.0.0"]
### 云环境变量
HOST=0.0.0.0 PORT=8000 ANTHROPIC_API_KEY=your-api-key CORS_ORIGINS=["https://yourdomain.com"]
## 🛡️ 安全特性
- **速率限制**:可配置的请求速率限制
- **CORS保护**:可配置的CORS源
- **输入验证**:基于Pydantic的请求验证
- **错误处理**:全面的错误处理和记录
- **API密钥安全**:安全的API密钥管理
## 📝 日志记录
服务器使用具有可配置级别的结构化日志记录:
import structlog logger = structlog.get_logger()
Logs are automatically structured with context
logger.info("Request processed", user_id=123, duration=0.5)
## 🤝 贡献
1. 分叉存储库
1. 创建要素分支
1. 进行更改
1. 添加测试
1. 提交拉取请求
## 📄 许可证
此项目根据GNU通用公共许可证v3.0获得许可-请参阅 [许可证](LICENSE) 文件以获取详细信息。
## 🙏 致谢
- **人类** API
- **快速API** 优秀的web框架
- **Python社区** 令人惊叹的库和工具
## 📞 支持
如需支持,请:
1. 检查 [文档](docs/)
1. 审查 [例子](examples/)
1. 在GitHub上打开一个问题
1. 加入我们的社区讨论
______________________________________________________________________
**快乐的Vibe编码! 🚀**