# MCPManager

**Repository Path**: zhangerhao/mcpmanager

## Basic Information

- **Project Name**: MCPManager
- **Description**: 用于项目管理的mcpserver，基于fastmcp与sqlite
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-05-25
- **Last Updated**: 2025-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FastMCP 服务器

本项目是基于 FastMCP 框架构建的 Model Context Protocol (MCP) 服务器，集成了 SQLite 数据库和现代化的 FastAPI 网页管理界面。支持 SSE/stdio 协议，适合中文场景的知识与配置管理。

## 主要特性

- **MCP 协议支持**：兼容 Claude、ChatGPT 等 AI 客户端，支持 create/update/delete/list/search 等标准工具调用。
- **Web 可视化管理**：内置 FastAPI 管理后台（自动并发启动，端口 8000），可视化增删改查和搜索。
- **数据项类型/状态全面中文化**：所有类型与状态枚举均为中文，支持从标题自动提取类型。
- **丰富的 API 工具与资源**：支持 RESTful 工具、资源 URI、提示模板等，便于二次开发和自动化。
- **极简部署**：仅需 Python 3.10+，pip 安装依赖即可运行。
- **详细文档**：`docs/` 目录下包含 API、数据库、配置等详细说明。

## 安装与运行

```bash
pip install fastmcp sqlalchemy
python3 main.py --transport sse --host 0.0.0.0 --port 8008
```
- MCP 主服务端口由 config.py 配置（默认 8008）
- Web 管理界面自动运行在 http://localhost:8000

## 目录结构

```
/mcpserver
  ├── main.py            # 主程序入口，自动并发启动MCP服务与Web管理界面
  ├── web_interface.py   # FastAPI网页管理界面
  ├── config.py          # 配置项
  ├── database.py        # 数据库模型与操作
  ├── templates/         # 网页模板
  ├── static/            # 静态文件
  ├── data.db            # SQLite数据库
  ├── README.md
  └── docs/              # 详细文档（API、配置、数据库等）
```

## 快速体验

1. 启动服务后，浏览器访问 http://localhost:8000 进入可视化管理后台。
2. 使用 Claude/ChatGPT 等 AI 客户端可直接调用 MCP 工具。
3. 支持数据项类型/状态自动中文识别，创建/编辑更智能。

## 典型工具与资源

- `create_item_tool`：创建数据项，类型自动提取
- `update_item_tool`：更新数据项，支持类型自动识别
- `delete_item_tool`：删除数据项
- `list_items_tool`：列出所有启用数据项
- `search_items_by_title`：按标题模糊搜索
- `db://item/{item_id}`：获取单项资源
- `db://items`：获取全部资源列表
- `item_template`/`list_template`：格式化输出模板

## 文档索引

- [docs/index.md](docs/index.md)：项目功能与文档总览
- [docs/quickstart.md](docs/quickstart.md)：快速开始与环境搭建
- [docs/api.md](docs/api.md)：API 工具与资源详细说明
- [docs/configuration.md](docs/configuration.md)：配置项详解
- [docs/database.md](docs/database.md)：数据库结构与模型说明

---

如需详细开发、二次集成、自动化脚本等方案，请查阅 docs 目录下相关文档。