Faust MCP-Faust DSP语言的模型上下文协议集成
Faust MCP 是一个全面的模型上下文协议(MCP)集成,使Claude AI能够使用生产级工具和文档编写、理解、分析、测试和调试Faust数字信号处理(DSP)代码。
______________________________________________________________________
什么是浮士德?
浮士德 是一种用于实时信号处理和合成的函数式编程语言。它编译成C++代码,可以针对嵌入式系统、Web Audio API、硬件合成器等。
为什么选择Faust MCP? Claude(和其他AI模型)现在可以理解DSP概念,编写正确的Faust代码,在编译前进行验证,调试错误,分析性能,并生成可用的音频处理器。
______________________________________________________________________
项目状态
✅ 完成 -所有核心组件均已交付并记录在案
| 组件 | 状态 | 版本 |
|---|---|---|
| 语言研究和DSP概念 | ✅ 完成 | 1.0 |
| MCP架构和规范 | ✅ 完成 | 1.0 |
| 代码测试框架 | ✅ 完成 | 1.0 |
| 语法分析器和Linter | ✅ 完成 | 1.0 |
| 编译器集成 | ✅ 完成 | 1.0 |
| 代码示例库 | ✅ 完成 | 1.0 |
| 文件和指南 | ✅ 完成 | 1.0 |
| 最佳实践指南 | ✅ 完成 | 1.0 |
| 性能分析工具 | ✅ 完成 | 1.0 |
| 调试框架 | ✅ 完成 | 1.0 |
| 集成测试 | ✅ 完成 | 1.0 |
| 克劳德代码技能 | ✅ 完成 | 1.0 |
______________________________________________________________________
📚 文档
核心文件
| 文档 | 目的 | 大小 | 焦点 |
|---|---|---|---|
| FAUST-LANGUAGE-RESEARCH.md | Faust基础知识综合 | ~25KB | 语言概念、语法、标准库 |
| MCP-规格.md | MCP集成设计 | ~15KB | 架构、工具、上下文协议 |
| MCP-QUICK参考.md | 快速查找指南 | ~8KB | 常见模式、工具语法 |
| MCP-USER-GUIDE.md | 如何使用MCP工具 | ~12KB | 工作流程、示例、最佳实践 |
框架指南
| 文档 | 目的 | 大小 | 焦点 |
|---|---|---|---|
| 测试框架-界面.md | 代码验证和测试 | ~18KB | 验证器、测试运行器、模式 |
| 最常见的种族.md | 设计模式和优化 | ~22KB | 模式、性能提示、反模式 |
| 调试框架-GUIDE.md | 错误诊断和修复 | ~16KB | 错误模式、诊断、解决方案 |
| SYNTAX-ANALYZER-GUIDE.md | 代码分析工具 | ~10KB | Linting、错误检测、重构 |
技术架构
| 文档 | 目的 | 大小 | 焦点 |
|---|---|---|---|
| 编译器集成架构.md | 编译器集成 | ~12KB | 执行、优化、输出处理 |
| 表演-分析-建筑.md | 性能工具 | ~10KB | 分析、指标、优化 |
调试与故障排除
| 文档 | 目的 | 大小 | 焦点 |
|---|---|---|---|
| 断层研究.md | 错误分类 | ~30KB | 错误模式、原因、解决方案 |
| 指南/初学者指南.md | 常见错误 | ~8KB | 前10个错误,快速修复 |
| 指南/信号处理问题.md | DSP问题 | ~47KB | 信号问题、因果关系、稳定性 |
| 技术/compiler-flags.md | 编译器调试 | ~5KB | 标志、调试策略 |
| 技术/错误解决.md | Bug搜寻 | ~6KB | 隔离技术、策略 |
| 技术/模块化测试.md | 测试方法 | ~7KB | 模块化设计,测试模式 |
快速入门和参考
| 文档 | 目的 | 大小 | 焦点 |
|---|---|---|---|
| SKILL-FAUT-MCP | Claude Code技能文档 | ~5KB | 安装、使用、激活 |
| 测试-质量标准.md | 快速入门 | ~4KB | 第一步,示例 |
______________________________________________________________________
🏗️ 架构概述
系统组件
┌─────────────────────────────────────────────────┐
│ Claude AI (with Faust MCP) │
│ │
│ Can now: │
│ • Write valid Faust code │
│ • Understand DSP concepts │
│ • Validate code before compilation │
│ • Debug compilation errors │
│ • Analyze performance │
│ • Generate documentation │
└──────────────┬──────────────────────────────────┘
│
│ Model Context Protocol (MCP)
│
┌──────────────┴──────────────────────────────────┐
│ Faust MCP Server │
│ │
│ Tools: │
│ 1. validate_faust_code() → Syntax check │
│ 2. compile_faust() → C++ generation │
│ 3. execute_faust() → Audio output │
│ 4. analyze_performance() → Metrics │
│ 5. explain_error() → Diagnosis │
│ 6. get_best_practices() → Guidance │
│ 7. get_code_examples() → Reference patterns │
└──────────────┬──────────────────────────────────┘
│
┌──────────────┴──────────────────────────────────┐
│ Faust DSP Language Toolchain │
│ │
│ • Faust compiler (→ C++) │
│ • C++ compiler (→ binary) │
│ • Standard library (dsp, filters, oscillators) │
│ • Multiple backends (AU, VST, Web Audio, etc) │
└─────────────────────────────────────────────────┘知识库
Documentation (200+ KB):
├── Language Research (25KB)
│ └── Syntax, concepts, standard library
├── Framework Guides (90KB)
│ ├── Testing & validation
│ ├── Best practices & patterns
│ ├── Debugging & error handling
│ ├── Performance optimization
│ └── Code analysis
├── Error Database (30KB)
│ └── 38+ error patterns with solutions
└── Quick References (20KB)
├── Common mistakes
├── Compiler techniques
└── Troubleshooting guides______________________________________________________________________
🎯 主要特点
1. 全面的语言理解
克劳德现在可以:
- 编写语法正确的Faust代码
- 了解DSP概念(滤波器、振荡器、延迟、反馈)
- 遵循浮士德的习语和惯例
- 避免常见陷阱
来源: FAUST-LANGUAGE-RESEARCH.md
2. 编译前的代码验证
语法检查:
- 基于模式的错误检测
- 语义分析
- 代码结构验证
- 最佳实践检查
3. 编译器集成
无缝编译:
- 自动生成C++代码
- 多种后端支持(AU、VST、Web音频、Faust DSP)
- 错误捕获和报告
- 性能指标
来源: 编译器集成架构.md
4. 自动错误诊断
了解错误:
- 与38+个已知错误模式进行模式匹配
- 信心评分解决方案
- 逐步诊断
- 修复代码示例
来源: 调试框架-GUIDE.md
5. 性能分析
测量和优化:
- 编译指标(时间、输出大小)
- 内存使用情况分析
- DSP效率指标
- 优化建议
来源: 表演-分析-建筑.md
6. 最佳实践指南
设计模式:
- 代码组织
- 性能优化
- 信号处理正确性
- 常见模式和习语
- 要避免的反模式
来源: 最常见的种族.md
7. 综合代码示例
30+参考示例:
- 振荡器(正弦、方形、锯齿形、三角形)
- 滤波器(低通、高通、带通、陷波)
- 效果(延迟、混响、失真、颤音)
- 合成器(减法、调频、波表)
- 控制模式(包络、LFO、调制)
来源: 文档/示例/
______________________________________________________________________
📖 文档地图
针对不同的受众
入门指南 (第一次使用浮士德+克劳德)
编写浮士德代码 (建筑处理器)
- 学习概念: FAUST-LANGUAGE-RESEARCH.md
- 参见示例: 文档/示例/
- 应用最佳实践: 最常见的种族.md
- 使用MCP工具: MCP-USER-GUIDE.md
调试问题 (修复错误)
- 快速修复: 指南/初学者指南.md
- 理解错误: 调试框架-GUIDE.md
- 深潜: 断层研究.md
- 技术: 技术/错误解决.md
高级主题 (优化、架构)
- 演出 表演-分析-建筑.md
- 模式: 最常见的种族.md
- DSP详细信息: 指南/信号处理问题.md
______________________________________________________________________
🚀 快速开始
安装
克隆此存储库:
git clone https://github.com/jessesep/faust-mcp-test.git
cd faust-mcp-test与克劳德一起使用
参考提示中的文档:
I want to build a Faust synthesizer.
Help me by using the faust-mcp documentation to:
1. Choose appropriate oscillators
2. Design the filter section
3. Add an ADSR envelope
4. Validate the code before compilation
You have access to:
- FAUST-LANGUAGE-RESEARCH.md (syntax and concepts)
- FAUST-BEST-PRACTICES.md (design patterns)
- docs/examples/ (reference code)
- DEBUGGING-FRAMEWORK-GUIDE.md (error solutions)验证Faust代码
创建一个文件并检查它:
# Create Faust code
cat > my-filter.dsp << 'EOF'
import("stdfaust.lib");
freq = hslider("Frequency", 1000, 20, 20000, 1);
process = fi.lowpass(3, freq);
EOF
# Validate syntax
# (reference SYNTAX-ANALYZER-GUIDE.md)______________________________________________________________________
📊 文档统计
- 文件总数: 200+KB
- 导游人数: 15+
- 代码示例: 30+
- 错误模式: 38+
- 快速参考: 5+
- 最佳实践: 20+
- 开发指南: 4+
______________________________________________________________________
🔧 工具和组件
文件(全部包含)
✅ 语言研究和DSP概念 ✅ MCP架构和规范 ✅ 代码测试框架指南 ✅ 语法分析器文档 ✅ 编译器集成指南 ✅ 性能分析工具 ✅ 使用错误数据库调试框架 ✅ 最佳实践和设计模式 ✅ 30+代码示例 ✅ 全面的错误指南 ✅ 快速参考资料
计划中的增强功能
- \[\]交互式网络文档
- \[\]VS代码扩展集成
- \[\]实时错误建议
- \[\]性能分析可视化
- \[\]协同调试工具
______________________________________________________________________
📝 文件结构
faust-mcp/
├── README.md # This file
├── TESTING-QUICK-START.md # Getting started guide
├── docs/
│ ├── FAUST-LANGUAGE-RESEARCH.md # Language fundamentals
│ ├── MCP-SPECIFICATION.md # MCP design
│ ├── MCP-QUICK-REFERENCE.md # Quick lookup
│ ├── MCP-USER-GUIDE.md # Usage guide
│ ├── MCP-WORKFLOWS.md # Common workflows
│ ├── MCP-CONFIGURATION.md # Configuration
│ ├── TESTING-FRAMEWORK-GUIDE.md # Testing docs
│ ├── FAUST-BEST-PRACTICES.md # Best practices
│ ├── FAUST-BEST-PRACTICES-GUIDE.md # Patterns guide
│ ├── DEBUGGING-FRAMEWORK-GUIDE.md # Debugging guide
│ ├── SYNTAX-ANALYZER-GUIDE.md # Analyzer docs
│ ├── COMPILER-INTEGRATION-ARCHITECTURE.md # Compiler docs
│ ├── PERFORMANCE-ANALYSIS-ARCHITECTURE.md # Performance docs
│ ├── SKILL-FAUST-MCP.md # Claude Code skill
│ ├── SKILL-INSTALLATION.md # Installation guide
│ ├── SKILL-PUBLISHING-CHECKLIST.md # Publishing guide
│ ├── faust-error-research.md # Error database
│ ├── faust-error-research.md # Error catalog
│ ├── debugging-framework-architecture.md # Framework design
│ ├── SYNTAX-ANALYZER-DESIGN.md # Analyzer design
│ ├── SYNTAX-ANALYZER-TESTING.md # Testing analyzer
│ ├── guides/
│ │ ├── beginner-mistakes.md # Top 10 mistakes
│ │ └── signal-processing-issues.md # DSP problems
│ ├── techniques/
│ │ ├── compiler-flags.md # Compiler debugging
│ │ ├── error-isolation.md # Bug hunting
│ │ └── modular-testing.md # Testing patterns
│ ├── examples/ # 30+ code examples
│ │ ├── oscillators/
│ │ ├── filters/
│ │ ├── effects/
│ │ └── synthesizers/
│ └── data/
│ └── error-patterns/ # Error database (JSON)
├── .gitignore # Git configuration
└── LICENSE # License information______________________________________________________________________
🤝 贡献
要改进Faust MCP文档:
- 修复错误: 在文档中发现错误?提交更正。
- 添加示例: 有浮士德的好榜样吗?添加到
docs/examples/. - 改进指南: 用新的见解增强现有指南。
- 添加错误模式: 发现新的浮士德错误?将其添加到数据库中。
看 贡献.md 详细指南。
______________________________________________________________________
📞 支持
快速问题
- 检查 MCP-QUICK参考.md 第一
- 审查 指南/初学者指南.md
错误诊断
- 看 调试框架-GUIDE.md
- 参考 断层研究.md
学习浮士德
- 开始: FAUST-LANGUAGE-RESEARCH.md
- 请参阅: 文档/示例/
- 最佳实践: 最常见的种族.md
______________________________________________________________________
📄 许可证
本Faust MCP文档和框架作为DSP学习和Claude AI集成的教育材料提供。
______________________________________________________________________
🙏 鸣谢
Faust MCP 被开发为一个全面的集成层,使Claude AI能够与Faust DSP语言有效地协同工作。
内置:
______________________________________________________________________
📚 其他资源
- 浮士德官方: http://faust.grame.fr/
- Faust文档: https://faustdoc.grame.fr/
- Faust IDE: https://faustide.grame.fr/
- 浮士德社区: https://github.com/grame-cncm/faust
- 克劳德·艾: https://anthropic.com/
______________________________________________________________________
准备好与Claude一起构建令人惊叹的Faust DSP代码了吗?从开始 测试-质量标准.md!
🎵 信号处理快乐!
