logo
0
0
WeChat Login
feat: 初始化项目并添加MCP服务器配置和文档

MCP 服务器配置说明

本项目配置了多个 MCP (Model Context Protocol) 服务器,用于扩展 AI 的功能。

什么是 MCP?

MCP (Model Context Protocol) 是 Anthropic 推出的开放协议,用于标准化 AI 模型与外部工具/数据源之间的连接。通过 MCP,AI 可以:

  • 🔧 调用外部工具 - 如文件系统、搜索引擎、计算工具等
  • 📊 访问外部数据 - 如数据库、API、本地文件等
  • 🎯 执行特定任务 - 如编译代码、生成随机数、排八字等

MCP 服务器列表

名称用途运行方式额外安装
searxng网络搜索引擎npx✅ npm install
Time MCP Server时间查询和时区转换uvx❌ 无需安装
MCP Server Make执行 Makefile 构建任务uvx❌ 无需安装
Everything Search本地文件搜索uvx⚠️ 需要配置 DLL 路径
novel-filesystem小说文件管理npx✅ npm install
novel-gitGit 版本控制npx✅ npm install
dice-roller骰子/随机数生成npx✅ npm install
fetch网页内容获取uvx❌ 无需安装
bazi八字排盘算命npx✅ npm install
wikipedia维基百科查询npx✅ npm install
wordWord 文档编辑npx✅ npm install
sqliteSQLite 数据库npx✅ npm install

详细说明

🔍 searxng - 网络搜索

用途: 使用 SearXNG 搜索引擎进行网络搜索

功能:

  • 搜索网页、新闻、图片、视频等内容
  • 获取实时信息、查询资料
  • 无需 API Key,自建或使用公共实例

环境变量:

  • SEARXNG_INSTANCES: SearXNG 服务地址,默认 http://localhost:8080
  • SEARXNG_USER_AGENT: 自定义 User-Agent

使用示例:

"搜索今天的新闻" "查询 Python 最新版本" "找一下关于量子计算的资料"

⏰ Time MCP Server - 时间服务

用途: 获取和转换时区时间

使用示例:

"现在几点?" "纽约现在是几点?" "转换北京时间到东京时间"

🛠️ MCP Server Make - 构建工具

用途: 执行 Makefile 中的构建任务

配置:

  • make-path: /workspace/Makefile
  • working-dir: /workspace

📁 novel-filesystem - 文件系统

用途: 管理小说文件和写作素材

权限目录:

  • /workspace/novels - 小说目录
  • /workspace/writing - 写作目录

使用示例:

"创建一个新的小说章节" "读取人物设定文件" "列出所有章节"

📚 novel-git - 版本控制

用途: 自动备份写作进度

使用示例:

"提交今天的写作" "查看修改历史" "回滚到昨天的版本"

🎲 dice-roller - 骰子/随机数

用途: 生成随机数、掷骰子

小说应用:

  • 给人物算命(掷卦、塔罗牌抽取)
  • 生成随机人物属性
  • 决定随机事件走向

使用示例:

"掷一个 20 面骰子" "生成 1-100 的随机数" "帮我抽一张塔罗牌"

🌐 fetch - 网页获取

用途: 抓取网页内容

使用示例:

"获取这个网页的内容" "搜索历史资料"

🔮 bazi - 八字排盘

用途: 专业八字排盘算命(由参天 AI 提供)

功能:

  • 精准八字排盘
  • 四柱、十神分析
  • 大运推算
  • 神煞查询
  • 黄历查询

使用示例:

"给我排一个 1990年5月15日早上8点的八字" "分析一下这个八字的性格" "查询今天的黄历"

📖 wikipedia - 维基百科

用途: 查询维基百科获取文学、历史、文化知识

文学应用:

  • 查询作家生平、作品介绍
  • 搜索文学流派、历史背景
  • 获取名著故事梗概
  • 查文学术语解释

使用示例:

"查询李白的生平" "什么是意识流文学?" "《红楼梦》的故事简介"

📝 word - Word 文档

用途: 创建和编辑 Microsoft Word 文档

文学应用:

  • 创建和编辑小说文档
  • 格式化文学作品
  • 导出为标准文档格式
  • 批量处理文档

使用示例:

"创建一个 Word 文档写第一章" "打开现有的小说文档" "保存为 PDF 格式"

🗄️ sqlite - SQLite 数据库

用途: 管理小说人物关系和设定数据

文学应用:

  • 创建人物信息表(姓名、性别、门派、武功等)
  • 建立人物关系网(师徒、仇敌、恋人、亲属等)
  • 查询角色的所有关系
  • 管理小说世界观设定(门派、地图、法宝等)

数据库路径: /workspace/novels/characters.db

使用示例:

"创建人物表:id, 姓名, 性别, 门派, 武功" "添加人物:杨过,男,古墓派,黯然销魂掌" "创建关系表记录人物关联" "查询杨过有哪些师父" "统计全真教有多少人"

安装依赖

需要 npm & npx 额外安装的 MCP

以下 MCP 服务器需要 Node.js 环境,并通过 npm/npx 运行:

# 确保已安装 Node.js 22+ 和 npm node --version npm --version # 以下 MCP 会自动通过 npx 下载运行,无需手动安装: # - searxng # - novel-filesystem # - novel-git # - dice-roller # - bazi # - wikipedia # - word # - sqlite # bazi-mcp 建议全局安装(可选) npm install -g bazi-mcp

需要 uv/uvx 的 MCP

以下 MCP 服务器使用 Python 的 uv 工具运行:

# 安装 uv (如果未安装) curl -LsSf https://astral.sh/uv/install.sh | sh # 以下 MCP 会自动通过 uvx 运行: # - Time MCP Server # - MCP Server Make # - Everything Search MCP Server # - fetch

配置文件位置

mcp.json.example 复制到以下位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

快速开始

  1. 复制配置文件:

    cp mcp.json.example /path/to/claude_desktop_config.json
  2. 修改配置文件中的路径(如需要)

  3. 重启 Claude Desktop 或其他 AI 客户端

  4. 开始使用!尝试说:

    • "搜索 MCP 是什么"
    • "给我排一个八字"
    • "掷一个骰子"

注意事项

  1. searxng 需要本地运行 SearXNG 服务或配置公共实例
  2. Everything Search 需要 Windows 系统和 Everything 软件
  3. bazi-mcp 需要 Node.js 22+ 版本
  4. 所有路径请根据实际情况修改

参考链接