使用说明

MCP服务器Monorepo

MCP（模型上下文协议）服务器的pnpm monorepo集合，用于将各种AI模型和服务与Claude Desktop集成。

📦 可用服务器

OpenAI GPT-5服务器

与OpenAI的GPT-5 API集成，支持灵活的人工智能交互的双接口。

包裹: @boseong/mcp-openai-gpt5
特性：双工具（简单+消息），增强的令牌报告，灵活的环境
文档

未来服务器（计划中）

Anthropic服务器：与Claude API直接集成
谷歌Gemini服务器：与谷歌的Gemini模型集成
本地LLM服务器：支持本地语言模型
数据库查询服务器：SQL和NoSQL数据库交互
Web剪贴服务器：高级网络内容提取

🚀 快速开始

先决条件

Node.js>=18.0.0
pnpm>=10.0.0（用于开发）
Claude桌面应用程序

备注：如果您有旧版本的pnpm，请使用以下工具升级：

pnpm add -g pnpm@latest

安装

每个服务器都可以通过npm独立安装：

# Install OpenAI GPT-5 server
npm install -g @boseong/mcp-openai-gpt5

或者直接与npx一起使用（无需安装）：

npx @boseong/mcp-openai-gpt5

配置

设置环境变量:

cp .env.example .env
# Edit .env with your API keys

配置Claude桌面:

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%/Claude/claude_desktop_config.json
```
{
  "mcpServers": {
    "gpt5": {
      "command": "npx",
      "args": ["@boseong/mcp-openai-gpt5"],
      "env": {
        "OPENAI_API_KEY": "your-api-key"
      }
    }
  }
}
```
备注：您可以使用其中之一 "gpt5" 或 "openai-gpt5" 作为服务器密钥名称。使用 "gpt5" 建议在Claude Code中更容易调用。

🛠️ 发展

Monorepo结构

mcp-servers/
├── packages/                  # All MCP server packages
│   ├── gpt5-server/          # GPT-5 MCP server
│   │   ├── src/              # TypeScript source
│   │   ├── dist/             # Compiled JavaScript (git-ignored)
│   │   ├── package.json      # Package configuration
│   │   └── README.md         # Server documentation
│   └── [other-servers]/      # Future MCP servers
├── .env.example              # Environment variables template
├── pnpm-workspace.yaml       # pnpm workspace configuration
├── tsconfig.json             # Root TypeScript configuration
├── package.json              # Root package.json with workspace scripts
├── .gitignore                # Git ignore rules
├── CLAUDE.md                 # Claude Code guidance
└── README.md                 # This file

创建新的MCP服务器

在下创建新目录 packages/:

mkdir packages/your-server-name
cd packages/your-server-name
pnpm init

安装MCP SDK：
```
pnpm add @modelcontextprotocol/sdk
```
遵循现有服务器的结构进行实施
添加TypeScript支持：
```
pnpm add -D typescript @types/node
```
配置构建过程并创建MCP服务器实现
将您的包添加到根tsconfig.json引用中

从源头构建

# Clone the repository
git clone https://github.com/boseong/mcp-servers.git
cd mcp-servers

# Install all dependencies using pnpm
pnpm install

# Build all packages
pnpm build

# Build a specific server
pnpm --filter gpt5-server build

开发工作流程

# Install dependencies for all packages
pnpm install

# Run development mode for all packages
pnpm dev

# Run development for specific package
pnpm --filter gpt5-server dev

# Build all packages
pnpm build

# Test all packages
pnpm test

# Clean all build artifacts
pnpm clean

📝 贡献

欢迎投稿！请随时提交拉取请求。

指南

遵循现有的代码结构和模式
添加全面的文档
包含TypeScript类型
提交前进行彻底测试
添加新服务器时更新此README

📄 许可证

每个服务器可能都有自己的许可证。检查各个服务器目录以获取特定的许可证信息。

GPT-5服务器：MIT许可证

🔗 资源

💬 支持

对于问题和疑问：

在GitHub存储库中创建问题
检查单个服务器文档
请参阅MCP文档

🚧 路线图

[x] 迁移到pnpm单仓库结构
[]添加更多AI模型集成
[]创建实用服务器（数据库、文件系统等）
[]为MCP服务器开发测试框架
[]添加服务器模板以快速开发
[]使用变更集创建自动发布工作流