声音修复MCP服务器
MCP（模型上下文协议）服务器，为治疗和健康应用提供治疗谐波频率。该服务器提供对众所周知的治疗频率、实验计算和创新频率生成方法的访问。
特性
井音频率
访问一个全面的知名治疗频率数据库，包括：
- 脉轮频率：基底（396赫兹）、骶骨（417赫兹）、太阳神经丛（528赫兹）、心脏（639赫兹）、喉咙（741赫兹）、第三只眼（852赫兹）、牙冠（963赫兹）
- 视唱练耳频率：整套古代视唱练耳音调（174、285、396、417、528、639、741、852、963赫兹）
- 地球共振：舒曼共振频率（7.83赫兹，8赫兹）
- A-432赫兹调谐：自然调谐频率
- 脑电波频率：Theta、Delta、Alpha、Beta、Gamma
实验计算
- 调和级数：从任何基频计算谐波级数
- 毕达哥拉斯比率：使用古代毕达哥拉斯比率生成频率
- 斐波那契频率：根据斐波那契数列创建频率
- 黄金比例（Phi）：使用黄金比例（1.618…）计算频率
- 主要和声：使用素数生成谐波
- Phi螺旋：按照黄金比例螺旋创建频率
创新方法
- 量子谐波：根据量子能级计算频率
- 分形频率：生成基于自相似分形的频率
- 谐振级联：创建级联谐振频率
- 自定义频率矩阵：结合多种数学原理，形成独特的频率矩阵
快速开始
- 克隆或下载此存储库
- 安装依赖项 （见下面的安装部分）
- 配置您的MCP客户端 （请参阅MCP客户端设置部分）
- 开始使用工具！
安装
第一步：安装Python
请确保您已安装Python 3.8或更高版本：
# Check Python version
python3 --version # macOS/Linux
python --version # Windows如果未安装Python，请从以下网址下载 python.org.
注：
- 在macOS/Linux上，您可能两者都有
python（Python 2）和python3（Python 3）。始终使用python3. - 在Windows上，
python如果安装正确，通常指Python 3。
步骤2：克隆或下载存储库
选项A：使用Git进行克隆
git clone https://github.com/yourusername/Sound-Healing-MCP.git
cd Sound-Healing-MCP选项B：下载ZIP
- 在GitHub上点击“下载ZIP”
- 将ZIP文件解压缩到所需位置
- 在提取的文件夹中打开终端
步骤3：安装依赖项
导航到存储库目录并安装所需的软件包：
macOS/Linux：
# Make sure you're in the Sound-Healing-MCP directory
cd Sound-Healing-MCP
# Install dependencies
pip3 install -r requirements.txt
# Or use python3 -m pip
python3 -m pip install -r requirements.txt窗户：
# Make sure you're in the Sound-Healing-MCP directory
cd Sound-Healing-MCP
# Install dependencies
pip install -r requirements.txt
# Or use python -m pip
python -m pip install -r requirements.txt验证安装：
# Check if mcp package is installed
pip3 list | grep mcp # macOS/Linux
pip list | findstr mcp # Windows步骤4：获取服务器路径
你需要 绝对路径 到 server.py 用于配置。以下是如何找到它：
macOS/Linux：
# Get the absolute path
pwd
# Output example: /Users/yourusername/GitHub/Sound-Healing-MCP
# Full path to server.py
echo "$(pwd)/server.py"
# Output: /Users/yourusername/GitHub/Sound-Healing-MCP/server.py窗户：
REM Get the absolute path
cd
REM Output example: C:\Users\yourusername\GitHub\Sound-Healing-MCP
REM Full path to server.py
cd
echo %CD%\server.py
REM Output: C:\Users\yourusername\GitHub\Sound-Healing-MCP\server.py重要提示：
- 使用 绝对路径 （从根开始的完整路径），而不是相对路径
- 复制此路径-下一步您将需要它
步骤5：测试安装（可选）
测试服务器是否可以启动：
# macOS/Linux
python3 server.py
# Windows
python server.py服务器将启动并等待连接（这是正常的）。按 Ctrl+C 阻止它。
MCP客户端设置
现在，您需要在MCP兼容客户端中配置服务器。这告诉您的客户端如何启动服务器并与服务器通信。
选择您的客户：
光标
- 安装服务器：
git clone https://github.com/yourusername/Sound-Healing-MCP.git
cd Sound-Healing-MCP
pip3 install -r requirements.txt- 查找您的光标MCP配置：
- 打开光标设置 - 导航到功能→ 模型上下文协议 - 或手动编辑： ~/.cursor/mcp.json （macOS/Linux）或 %APPDATA%\Cursor\mcp.json （Windows）
- 添加服务器配置：
{
"mcpServers": {
"sound-healing": {
"command": "python3",
"args": ["/absolute/path/to/Sound-Healing-MCP/server.py"]
}
}
}重要提示： 替换 /absolute/path/to/Sound-Healing-MCP/server.py 带有server.py文件的实际路径。
- 重新启动游标
- 验证安装： 声音修复工具现在应该可以在Cursor的MCP工具中使用。
克劳德桌面
- 安装服务器：
git clone https://github.com/yourusername/Sound-Healing-MCP.git
cd Sound-Healing-MCP
pip3 install -r requirements.txt- 查找您的Claude Desktop配置文件：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json
- 编辑或创建配置文件：
如果文件不存在，则创建它。如果存在，则添加到现有文件中 mcpServers 对象：
{
"mcpServers": {
"sound-healing": {
"command": "python3",
"args": ["/absolute/path/to/Sound-Healing-MCP/server.py"]
}
}
}macOS/Linux示例：
{
"mcpServers": {
"sound-healing": {
"command": "python3",
"args": ["/Users/yourusername/GitHub/Sound-Healing-MCP/server.py"]
}
}
}Windows示例：
{
"mcpServers": {
"sound-healing": {
"command": "python",
"args": [
"C:\\Users\\yourusername\\GitHub\\Sound-Healing-MCP\\server.py"
]
}
}
}- 重新启动克劳德桌面
- 验证安装： 打开Claude Desktop，开始对话，并检查声音修复工具是否可用。
其他MCP客户端
对于其他MCP兼容客户端，配置格式通常为：
{
"mcpServers": {
"sound-healing": {
"command": "python3",
"args": ["/path/to/server.py"]
}
}
}提示：
- 使用绝对路径（而不是相对路径）
- 在macOS/Linux上，使用
python3。在Windows上，使用python - 确保Python和
mcp包在您的PATH中 - 更改配置后重新启动客户端
- 看
mcp-config-examples/目录，例如配置文件
快速设置脚本
您可以使用提供的安装脚本自动安装依赖项并获取服务器路径：
macOS/Linux：
./setup-mcp.sh窗户：
setup-mcp.bat用法
运行服务器
# On macOS/Linux, use python3
python3 server.py
# On Windows, use:
python server.py重要提示： 此MCP服务器使用 标准 （标准输入/输出）用于通信，而不是HTTP/端口。它通过stdin/stdout流进行通信，这是MCP服务器的标准工作方式。服务器在stdin上等待MCP协议消息，并在stdout上做出响应。
运行服务器时，它将等待MCP客户端连接。您通常在MCP兼容的客户端（如Claude Desktop、Cursor或其他MCP客户端）中配置此服务器，客户端在其中启动服务器进程并通过stdio与之通信。
可用工具
井音工具
get_well_tone_frequency：按名称获取特定的音调频率list_all_well_tones：按类别列出所有可用的音调频率get_chakra_frequencies：获取所有脉轮治疗频率
计算工具
calculate_harmonic_series：根据基频计算谐波级数calculate_pythagorean_frequency：使用毕达哥拉斯比率计算calculate_fibonacci_frequency：根据斐波那契数列计算calculate_golden_ratio_frequency：使用黄金比例计算calculate_prime_harmonics：使用素数计算谐波generate_phi_spiral_frequencies：生成黄金比例螺旋频率
创新工具
calculate_quantum_harmonic：计算量子级谐波generate_fractal_frequencies：生成基于分形的频率calculate_resonance_cascade：计算谐振级联频率generate_custom_frequency_matrix：结合多种原理生成自定义频率矩阵
示例用法
工具调用示例
获取脉轮频率
{
"tool": "get_well_tone_frequency",
"arguments": {
"frequency_name": "chakra_heart"
}
}预期结果： 返回心脏脉轮频率（639 Hz）
列出所有井音频率
{
"tool": "list_all_well_tones",
"arguments": {}
}预期结果： 返回按类别组织的所有音调频率
计算谐波级数
{
"tool": "calculate_harmonic_series",
"arguments": {
"base_frequency": 440,
"harmonics_count": 10
}
}预期结果： 返回从440 Hz开始的10个谐波频率的数组
生成Phi螺旋频率
{
"tool": "generate_phi_spiral_frequencies",
"arguments": {
"base_frequency": 432,
"count": 10
}
}预期结果： 返回遵循黄金比例螺旋模式的频率
计算量子谐波
{
"tool": "calculate_quantum_harmonic",
"arguments": {
"base_frequency": 528,
"quantum_level": 5
}
}预期结果： 返回使用量子能级公式计算的频率（528×5²=13200 Hz）
在对话中使用
在Cursor或Claude Desktop中，您可以简单地问：
- “脉轮频率是多少？”
- “计算432 Hz的谐波级数”
- “生成从528 Hz开始的分形频率”
- “显示所有Solfeggio频率”
- “基频440 Hz时3级的量子谐波是多少？”
AI会自动调用相应的工具。
频率类别
脉轮频率
- 基/根：396赫兹-从恐惧和内疚中解放出来
- Sacral：417 Hz-消除情况并促进变化
- 太阳丛：528赫兹-转变与奇迹（DNA修复）
- 心脏：639赫兹-连接和关系
- 喉部：741 Hz-表现和解决方案
- 第三只眼：852赫兹-回归精神秩序
- 皇冠：963赫兹-与更高意识的连接
视唱练耳频率
神圣音乐中使用的古代六音音阶：
- 174 Hz-意识发展的基础
- 285 Hz-量子认知和量子意识
- 396 Hz-从恐惧和内疚中解放出来
- 417 Hz-促进变革
- 528赫兹-变换与奇迹
- 639 Hz-连接和关系
- 741 Hz-表达式和解决方案
- 852赫兹-回归精神秩序
- 963赫兹-与更高意识的连接
地球共振
- 7.83 Hz-舒曼共振（地球固有频率）
- 8 Hz-舒曼基共振
- 432 Hz-自然调谐频率（A4）
脑电波国家
- Δ：0.5-4Hz-深度睡眠，康复
- Theta：4-8Hz-深度冥想，创造力
- 阿尔法：8-13Hz-放松意识，流动状态
- Beta：13-30赫兹-积极思考，专注
- 伽玛：30-100Hz-峰值浓度，洞察力
科学背景
此服务器结合了：
- 传统知识：声音治疗中使用的成熟治疗频率
- 数学原理：斐波那契数列、黄金比例、素数、分形
- 量子概念：量子谐波的能级计算
- 实验方法：频率生成的新方法
许可证
本项目按原样提供供公众使用。请负责任地使用，并就医疗应用咨询医疗保健专业人员。
故障排除
服务器无法启动
问题： 服务器未启动或显示错误。
解决：
- 检查Python版本：
python3 --version（应为3.8或更高） - 验证是否安装了依赖项：
pip3 list | grep mcp - 重新安装依赖关系：
pip3 install --upgrade -r requirements.txt - 检查文件路径是否正确和绝对（不是相对）
客户端中未显示工具
问题： 工具不会显示在Cursor/Claude Desktop中。
解决：
- 验证配置文件语法（有效的JSON）
- 检查路径是否绝对正确
- 使用正确的Python命令(
python3在macOS/Linux上，python在Windows上） - 完全重新启动客户端（退出并重新打开）
- 检查客户端日志是否有错误
- 验证Python和
mcp包位于PATH中
“找不到命令”错误
问题： 客户端找不到Python。
解决：
- 查找Python路径：
which python3（macOS/Linux）或where python（Windows） - 在配置中使用完整路径：
"/usr/bin/python3"而不仅仅是"python3" - 验证Python是否已安装并位于PATH中
路径问题
问题： 找不到服务器文件。
解决：
- 使用绝对路径（从根开始的完整路径）
- 在Windows上，使用双反斜杠：
C:\\Users\\... - 在macOS/Linux上，使用正斜杠：
/Users/... - 验证文件是否存在于该路径
- 检查路径中的拼写错误
权限错误
问题： 运行服务器时权限被拒绝。
解决：
- 确保Python脚本可读：
chmod +r server.py - 检查目录权限
- 在Linux/macOS上，您可能需要调整文件权限
还有问题吗？
- 检查客户端的MCP日志（通常在客户端设置或日志文件夹中）
- 手动测试服务器：
python3 server.py（它应该开始并等待） - 验证MCP协议与您的客户端版本的兼容性
- 尝试一个简单的测试：使用终端中的绝对路径来验证它是否有效
贡献
欢迎投稿！您可以随意添加新的频率计算方法、额外的井音频率或改进现有功能。
如何贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 彻底测试
- 提交拉取请求
贡献的想法
- 额外的井音频率
- 新的计算方法
- 性能改进
- 文档增强
- 其他MCP客户端的示例配置
- 测试和测试覆盖率
免责声明
此服务器提供用于信息和研究目的的频率。良好的治疗频率是互补的做法，不应取代医疗。始终咨询合格的医疗保健专业人员了解医疗状况。