团队 MCP 工具集

这是一个为团队开发的 MCP (Model Context Protocol) 工具服务器，提供多个实用工具供 AI 助手使用。

🛠️ 包含的工具

1. hello - 问候工具

向指定的人问好

• 参数：name (字符串)

2. get_time - 时间工具

获取当前时间

• 无需参数

3. calculate - 计算器工具

执行基本数学计算（加减乘除）

• 参数：a (数字)、b (数字)、operation (add|subtract|multiply|divide)

4. read_note - 笔记读取工具

读取 notes 目录下的笔记文件

• 参数：filename (字符串)

📦 安装

npm install kpclub-mcp-tools

🚀 使用方法

在 Claude Desktop 中使用

编辑配置文件：

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

添加配置：

{
  "mcpServers": {
    "kpclub-tools": {
      "command": "npx",
      "args": ["kpclub-mcp-tools"]
    }
  }
}

在 Cursor/Qoder 中使用

编辑用户设置 JSON（Cmd/Ctrl + Shift + P → Preferences: Open User Settings (JSON)）：

{
  "mcpServers": {
    "kpclub-tools": {
      "command": "npx",
      "args": ["kpclub-mcp-tools"]
    }
  }
}

本地开发测试

# 克隆项目
git clone <your-repo-url>
cd mcp-hello-server

# 安装依赖
npm install

# 构建
npm run build

# 使用 Inspector 测试
npm run inspector

# 开发模式
npm run dev

🔧 开发

添加新工具

1. 在 src/index.ts 的 tools 数组中注册新工具
2. 在 CallToolRequestSchema 处理器中添加工具逻辑
3. 运行 npm run build 编译
4. 运行 npm run inspector 测试

目录结构

.
├── src/
│   └── index.ts       # 主服务器代码
├── dist/              # 编译输出
├── notes/             # 示例笔记文件
├── package.json
└── tsconfig.json

📝 版本更新

修改 package.json 中的 version 字段，然后发布：

npm version patch  # 1.0.0 -> 1.0.1
npm version minor  # 1.0.0 -> 1.1.0
npm version major  # 1.0.0 -> 2.0.0
npm publish

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 License

MIT