模型上下文协议服务器

一个提供多种服务集成能力的模型上下文协议服务器,支持Cal.com集成、环境变量配置和多种传输模式。

  • by michalstypa
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 michalstypa/mcp-server

使用说明

Backtick MCP服务器

一种模型上下文协议(MCP)服务器,为各种服务提供集成功能。

特性

  • 演示工具:基本测试和实用工具(ECHO、SYSTEM_INFO、RANDOM_UUID)
  • Cal.com集成:从Cal.com获取可用的会议时段
  • 环境变量支持:可通过.env文件进行配置
  • 多种运输方式:STDIO和HTTP支持

快速开始

1.安装依赖项

npm install

2.构建服务器

npm run build

3.配置环境变量

创建一个 .env 项目根目录中的文件:

# Cal.com Integration Configuration
CALCOM_API_TOKEN=your_calcom_api_token_here
CALCOM_API_BASE=https://api.cal.com

4.运行服务器

# STDIO mode (default)
npm start

# HTTP mode
npm start -- --http --port=3000

Claude桌面集成

要将此MCP服务器与Mac上的Claude Desktop一起使用:

1.配置克劳德桌面

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "backtick-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/project/dist/index.js"],
      "env": {
        "CALCOM_API_TOKEN": "your_calcom_api_token_here",
        "CALCOM_API_BASE": "https://api.cal.com"
      }
    }
  }
}

替换 /path/to/your/project 根据您的实际项目路径。

2.重新启动克劳德桌面

完全退出并重新启动Claude Desktop应用程序以加载新配置。

3.可用工具

配置后,Claude将可以访问:

  • 回声:使用可选的大写字母和前缀测试消息格式
  • 系统信息:获取服务器系统信息
  • 随机用户:生成随机UUID(一次1-10个)
  • 获取可用地块:获取Cal.com会议可用性

发展

脚本

  • npm run build -将TypeScript构建为JavaScript
  • npm run dev -以热重载的开发模式运行
  • npm test -运行测试
  • npm run lint -运行ESLint
  • npm run format -使用Prettier格式化代码

项目结构

src/
├── features/           # Feature implementations
│   ├── demo/          # Demo tools (no external dependencies)
│   └── calcom/        # Cal.com integration
├── infra/             # Infrastructure (config, logging, features)
└── index.ts           # Main entry point

许可证

无执照的