使用说明

项目简介

Waldzell MCP Servers 是一个包含多个 Model Context Protocol (MCP) 服务器实现的仓库,旨在增强AI助手的功能,使其能够访问外部数据和执行特定任务。仓库包含针对不同场景设计的MCP服务器,例如:

  • Yelp Fusion AI MCP Server: 集成 Yelp Fusion API,提供丰富的本地商业信息查询和交互能力。
  • Stochastic Thinking MCP Server: 提供基于随机算法的思维工具,辅助决策过程。
  • Clear Thought MCP Server: 提供结构化思维工具,如思维模型和调试方法,帮助用户清晰地分析和解决问题。

主要功能点

  • 资源访问: Yelp Fusion AI MCP Server 允许AI助手通过自然语言访问Yelp的商业数据,包括商家搜索、评价、活动信息等。
  • 思维增强工具: Stochastic Thinking 和 Clear Thought MCP Server 提供多种思维工具,例如:
    • 思维模型 (Mental Model):应用结构化的思维框架(如第一性原理、机会成本分析等)来分析问题。
    • 调试方法 (Debugging Approach):使用系统化的调试策略(如二分查找、逆向工程等)解决技术问题。
    • 顺序思考 (Sequential Thinking):支持动态和反思性的思考过程,逐步分析和解决复杂问题。
  • 标准化协议: 所有服务器均基于 MCP 协议构建,确保与兼容 MCP 协议的客户端进行标准化通信。
  • 易于部署: 仓库结构使用 Turborepo 和 NPM Workspaces 进行管理,方便开发、构建和部署。

安装步骤

  1. 克隆仓库

    git clone https://github.com/waldzellai/waldzell-mcp.git
    cd waldzell-mcp
  2. 安装依赖

    npm install

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以下是不同服务器的配置示例,您需要根据实际使用的客户端填写配置信息。

  • Clear Thought Server 和 Stochastic Thinking Server (server-clear-thought, server-stochasticthinking)

    这两个服务器的配置方式相同,以 'server-clear-thought' 为例:

    {
      "serverName": "clear-thinking-server",
      "command": "node",
      "args": ["packages/server-clear-thought/dist/index.js"]
    }

    参数说明:

    • 'serverName': 服务器名称,可自定义,用于在客户端中识别。例如 '"clear-thinking-server"'。
    • 'command': 启动服务器的命令,通常为 '"node"'。
    • 'args': 命令参数,指向服务器入口文件。对于 'server-clear-thought',应设置为 '["packages/server-clear-thought/dist/index.js"]'。对于 'server-stochasticthinking',应设置为 '["packages/server-stochasticthinking/dist/index.js"]'。
  • Yelp Fusion AI MCP Server (yelp-fusionai-mcp)

    Yelp Fusion AI MCP Server 需要配置 Yelp API 密钥才能正常工作。

    {
      "serverName": "yelp-fusionai-mcp",
      "command": "node",
      "args": ["packages/yelp-fusionai-mcp/dist/index.js"],
      "env": {
        "YELP_API_KEY": "<您的 Yelp API 密钥>",
        "YELP_CLIENT_ID": "<您的 Yelp Client ID>"
      }
    }

    参数说明:

    • 'serverName': 服务器名称,可自定义,例如 '"yelp-fusionai-mcp"'。
    • 'command': 启动服务器的命令,通常为 '"node"'。
    • 'args': 命令参数,指向服务器入口文件。应设置为 '["packages/yelp-fusionai-mcp/dist/index.js"]'。
    • 'env': 环境变量配置,用于设置 Yelp API 密钥。
      • 'YELP_API_KEY': 请替换为您的 Yelp Fusion API 密钥
      • 'YELP_CLIENT_ID': 请替换为您的 Yelp Client ID

基本使用方法

  1. 启动服务器: 在克隆的仓库根目录下,针对您需要使用的服务器,执行相应的启动命令,例如:

    # 启动 Clear Thought Server
    node packages/server-clear-thought/dist/index.js
    
    # 启动 Stochastic Thinking Server
    node packages/server-stochasticthinking/dist/index.js
    
    # 启动 Yelp Fusion AI MCP Server (请先配置 .env 文件)
    node packages/yelp-fusionai-mcp/dist/index.js
  2. 配置 MCP 客户端: 在兼容 MCP 协议的客户端(如 Claude Desktop)中,添加新的 MCP 连接,并根据上述 服务器配置 部分填写相应的配置信息,包括服务器名称、启动命令和参数。

  3. 使用工具: 连接成功后,即可在 MCP 客户端中使用服务器提供的工具。例如,在 Claude 中,您可以:

    • 使用自然语言查询 Yelp 商家信息,例如 “附近有什么好吃的披萨店?” (使用 Yelp Fusion AI MCP Server)。
    • 使用 'mentalmodel' 工具进行思维模型分析,例如 “使用第一性原理分析电动汽车的未来发展” (使用 Clear Thought Server)。
    • 使用 'stochasticalgorithm' 工具应用随机算法解决决策问题 (使用 Stochastic Thinking Server)。

信息

分类

AI与计算