MCP励志语句管理器

@ronniemh/phrases-MCP-server

0 Stars 16 次浏览 ronniemh 更新于 2026-08-23

一个优雅的MCP服务器，允许用户通过桌面版Claude直接管理励志语句，为带有作者署名的语句提供完整的CRUD操作。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "phrases": {
      "args": [
        "/RUTA_ABSOLUTA_A/phrases/build/index.js"
      ],
      "command": "node"
    }
  }
}

服务介绍

🤖 Phrases MCP Server

一个优雅且高效的MCP（Model Context Protocol）服务器，用于管理鼓舞人心的短语。设计用于与Claude for Desktop及其他MCP客户端完美集成。

✨ 特性

全面的短语管理 - 轻松创建、读取、更新和删除短语
与Claude for Desktop集成 - 直接从Claude中与你的短语交互
内置API Mock - 使用API Mock进行测试和开发

🛠️ 可用工具

不适用
该服务器公开了以下MCP工具：

工具	描述
`get-all-phrases`	获取所有可用短语
`get-phrase-by-id`	根据ID查找短语
`get-phrase-by-name`	根据作者名查找短语
`create-phrase`	创建新短语
`update-phrase`	更新现有短语的文本
`delete-phrase`	根据ID删除短语

🚀 安装

# Clonar el repositorio
git clone https://github.com/ronniemh/phrases-MCP-server.git
cd phrases-MCP-server

# Instalar dependencias
npm install

# Compilar el proyecto
npm run build

🔌 与Claude for Desktop配置

安装Claude for Desktop（确保使用最新版本）
配置Claude for Desktop以使用此MCP服务器：

打开(MAC/Linux)配置文件：
```
~/Library/Application Support/Claude/claude_desktop_config.json
```

添加服务器配置：

{
    "mcpServers": {
        "phrases": {
            "command": "node",
            "args": [
                "/绝对路径/phrases/build/index.js"
            ]
        }
    }
}

重启Claude for Desktop

💡 与Claude一起使用

配置完成后，你可以直接通过Claude for Desktop与你的短语互动：

“显示所有可用短语”
“查找[作者名]的短语”
“为[名字]创建一条内容为[文本]的新短语”
“将ID为[数字]的短语更新为[新文本]”
“删除ID为[数字]的短语”

🧪 测试

⚠️ 注意：测试前配置

在运行测试之前，你需要临时修改tsconfig.json文件。将compilerOptions部分更改为：

"compilerOptions": {
  "target": "ES2020",
  "module": "NodeNext",
  "moduleResolution": "NodeNext",
  "esModuleInterop": true,
  "outDir": "build",
  "strict": true
}

注意：测试后别忘了恢复原始设置，以便MCP服务器能够正确编译。

要运行测试：

npm run test:requests

此命令将执行一系列使用Mock API来创建、读取、更新和删除短语的测试。

🏗️ 项目结构

src/
├── helpers/
│   └── makeMockAPIRequest.ts  # Funciones de ayuda para interactuar con la API
├── index.ts                   # Punto de entrada principal y definición de herramientas
└── testRequest.ts             # Script para probar las funciones de la API

🔄 开发工作流程

在src/目录下修改代码
使用npm run build编译
使用npm run test:requests进行测试
重启Claude for Desktop以应用更改

🔍 MockAPI配置

Este proyecto utiliza MockAPI 作为后端来存储和管理语句。配置的基础 URL 是：

https://67ec86aeaa794fb3222e0682.mockapi.io/frases/api/v1/user

配置你自己的 MockAPI 实例

在 MockAPI 上创建一个账号
创建一个新的项目
创建一个名为 user 的资源，包含以下字段：
- id (数字，自动生成)
- name (字符串)
- phrase (字符串)
复制你的 API URL
更新文件 src/helpers/makeMockAPIRequest.ts 中的 BASE_URL 常量

// Cambia esta línea con tu propia URL de MockAPI
const BASE_URL = "https://tu-proyecto.mockapi.io/tu-path/user";

📝 其他注意事项

该服务器使用了一个模拟 API 来存储数据。在生产环境中，请考虑实现一个真实的数据库。
项目的结构遵循了 MCP 官方指南以提高可维护性。
如果你在使用模拟 API 时遇到问题，请检查 MockAPI 的免费使用限制。

📄 许可证

ISC

查看源码项目主页