使用说明
项目简介
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 进行管理,方便开发、构建和部署。
安装步骤
-
克隆仓库
git clone https://github.com/waldzellai/waldzell-mcp.git cd waldzell-mcp -
安装依赖
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。
基本使用方法
-
启动服务器: 在克隆的仓库根目录下,针对您需要使用的服务器,执行相应的启动命令,例如:
# 启动 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 -
配置 MCP 客户端: 在兼容 MCP 协议的客户端(如 Claude Desktop)中,添加新的 MCP 连接,并根据上述 服务器配置 部分填写相应的配置信息,包括服务器名称、启动命令和参数。
-
使用工具: 连接成功后,即可在 MCP 客户端中使用服务器提供的工具。例如,在 Claude 中,您可以:
- 使用自然语言查询 Yelp 商家信息,例如 “附近有什么好吃的披萨店?” (使用 Yelp Fusion AI MCP Server)。
- 使用 'mentalmodel' 工具进行思维模型分析,例如 “使用第一性原理分析电动汽车的未来发展” (使用 Clear Thought Server)。
- 使用 'stochasticalgorithm' 工具应用随机算法解决决策问题 (使用 Stochastic Thinking Server)。
信息
分类
AI与计算