Sound Healing MCP

声音修复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螺旋：按照黄金比例螺旋创建频率

创新方法

• 量子谐波：根据量子能级计算频率
• 分形频率：生成基于自相似分形的频率
• 谐振级联：创建级联谐振频率
• 自定义频率矩阵：结合多种数学原理，形成独特的频率矩阵

快速开始

1. 克隆或下载此存储库
2. 安装依赖项 （见下面的安装部分）
3. 配置您的MCP客户端 （请参阅MCP客户端设置部分）
4. 开始使用工具！

安装

第一步：安装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

1. 在GitHub上点击“下载ZIP”
2. 将ZIP文件解压缩到所需位置
3. 在提取的文件夹中打开终端

步骤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兼容客户端中配置服务器。这告诉您的客户端如何启动服务器并与服务器通信。

选择您的客户：

光标

1. 安装服务器：

   git clone https://github.com/yourusername/Sound-Healing-MCP.git
   cd Sound-Healing-MCP
   pip3 install -r requirements.txt

1. 查找您的光标MCP配置：

- 打开光标设置 - 导航到功能→ 模型上下文协议 - 或手动编辑： ~/.cursor/mcp.json （macOS/Linux）或 %APPDATA%\Cursor\mcp.json （Windows）

1. 添加服务器配置：

   {
     "mcpServers": {
       "sound-healing": {
         "command": "python3",
         "args": ["/absolute/path/to/Sound-Healing-MCP/server.py"]
       }
     }
   }

重要提示： 替换 /absolute/path/to/Sound-Healing-MCP/server.py 带有server.py文件的实际路径。

1. 重新启动游标

1. 验证安装： 声音修复工具现在应该可以在Cursor的MCP工具中使用。

克劳德桌面

1. 安装服务器：

   git clone https://github.com/yourusername/Sound-Healing-MCP.git
   cd Sound-Healing-MCP
   pip3 install -r requirements.txt

1. 查找您的Claude Desktop配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 编辑或创建配置文件：

如果文件不存在，则创建它。如果存在，则添加到现有文件中 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"
         ]
       }
     }
   }

1. 重新启动克劳德桌面

1. 验证安装： 打开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-峰值浓度，洞察力

科学背景

此服务器结合了：

• 传统知识：声音治疗中使用的成熟治疗频率
• 数学原理：斐波那契数列、黄金比例、素数、分形
• 量子概念：量子谐波的能级计算
• 实验方法：频率生成的新方法

许可证

本项目按原样提供供公众使用。请负责任地使用，并就医疗应用咨询医疗保健专业人员。

故障排除

服务器无法启动

问题： 服务器未启动或显示错误。

解决：

1. 检查Python版本： python3 --version （应为3.8或更高）
2. 验证是否安装了依赖项： pip3 list | grep mcp
3. 重新安装依赖关系： pip3 install --upgrade -r requirements.txt
4. 检查文件路径是否正确和绝对（不是相对）

客户端中未显示工具

问题： 工具不会显示在Cursor/Claude Desktop中。

解决：

1. 验证配置文件语法（有效的JSON）
2. 检查路径是否绝对正确
3. 使用正确的Python命令(python3 在macOS/Linux上， python 在Windows上）
4. 完全重新启动客户端（退出并重新打开）
5. 检查客户端日志是否有错误
6. 验证Python和 mcp 包位于PATH中

“找不到命令”错误

问题： 客户端找不到Python。

解决：

1. 查找Python路径： which python3 （macOS/Linux）或 where python （Windows）
2. 在配置中使用完整路径： "/usr/bin/python3" 而不仅仅是 "python3"
3. 验证Python是否已安装并位于PATH中

路径问题

问题： 找不到服务器文件。

解决：

1. 使用绝对路径（从根开始的完整路径）
2. 在Windows上，使用双反斜杠： C:\\Users\\...
3. 在macOS/Linux上，使用正斜杠： /Users/...
4. 验证文件是否存在于该路径
5. 检查路径中的拼写错误

权限错误

问题： 运行服务器时权限被拒绝。

解决：

1. 确保Python脚本可读： chmod +r server.py
2. 检查目录权限
3. 在Linux/macOS上，您可能需要调整文件权限

还有问题吗？

1. 检查客户端的MCP日志（通常在客户端设置或日志文件夹中）
2. 手动测试服务器： python3 server.py （它应该开始并等待）
3. 验证MCP协议与您的客户端版本的兼容性
4. 尝试一个简单的测试：使用终端中的绝对路径来验证它是否有效

贡献

欢迎投稿！您可以随意添加新的频率计算方法、额外的井音频率或改进现有功能。

如何贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 彻底测试
5. 提交拉取请求

贡献的想法

• 额外的井音频率
• 新的计算方法
• 性能改进
• 文档增强
• 其他MCP客户端的示例配置
• 测试和测试覆盖率

免责声明

此服务器提供用于信息和研究目的的频率。良好的治疗频率是互补的做法，不应取代医疗。始终咨询合格的医疗保健专业人员了解医疗状况。