Metadata-Version: 2.4
Name: jewei-mcp-server-template
Version: 0.10.6.1123
Summary: mcp server template
Author-email: Jewei <jiweifong@qq.com>
Project-URL: Homepage, https://github.com/jeweis/mcp-server-template
Project-URL: Bug Tracker, https://github.com/jeweis/mcp-server-template/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: python-dotenv>=0.19.0
Requires-Dist: httpx>=0.24.0

# MCP Server 项目模板

这是一个MCP Server 项目模板，提供了以下功能：

- 示例提供了工具hello_word_tool


## MCP 使用配置

本项目支持通过多种客户端配置 MCP 服务器，以便与各种 IDE 或工具集成。以下是一些常见客户端的配置示例：

### Claude Code
1. 配置文件
```json
{
  "mcpServers": {
    "context7": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-template"]
    }
  }
}

```
2. cli
```bash
claude mcp add mcp-server-template --scope project uvx mcp-server-template
```

### Windsurf / Cursor / Claude

对于基于 Windsurf 框架的客户端（如 Cursor 和 Claude），您可以在 `~/.codeium/windsurf/mcp_config.json` 文件中配置 MCP 服务器。以下是一个示例配置：

```json
{
  "mcpServers": {
    "mcp-server-template": {
      "disabled": false,
      "command": "uvx",
      "args": [
        "mcp-server-template"
      ]
    }
  }
}
```


### Cline

对于 Cline 客户端，您可以在其配置文件中添加类似的 MCP 服务器配置。具体的配置方式请参考 Cline 的官方文档。通常，您需要指定服务器的名称、命令、参数和环境变量。

```json
// Cline 配置文件示例 (具体格式请参考 Cline 文档)
{
  "mcpServers": {
    "mcp-server-template": {
      "command": "uvx",
      "args": [
        "mcp-server-template"
      ]
    }
  }
}
```

## 源码安装

1. 克隆仓库
2. 安装依赖：`pip install -r requirements.txt`
3. 配置环境变量（参见下文）

### 配置

在项目根目录创建`.env`文件，包含以下环境变量：

```
# 服务名
SERVER_NAME=My-MCP-Server
CONTEXT_PATH=
PORT=9087
TYPE=streamable-http
```

### 运行

### 运行命令
```bash
python server.py
```

### 使用uvx安装并运行（推荐）

```bash
uvx mcp-server-template
```


### 说明
1. “xxx.xx.xx.xxx”需要换成本机ip
2. 环境变量按实际需求配置

