浮动MCP服务器
一个基于FastAPI的服务器,用于与Float API集成,并为时间记录和项目管理提供模型上下文协议(MCP)端点。
特性
- 用于将时间条目记录到Float的RESTful API
- 健康检查端点
- Docker化,易于部署
- 可通过环境变量进行配置
需求
- Python 3.13+
- 紫外线 (用于依赖关系管理)
- Docker(用于容器化部署)
安装
- 克隆存储库:
git clone https://github.com/your-org/float-mcp-server.git
cd float-mcp-server- 安装依赖项:
uv pip install -r requirements.txt或使用提供的 pyproject.toml 紫外线:
uv pip install -r pyproject.toml用法
地方发展
- 格式和纹理:
make ruff- 清理构建工件:
make clean- 在本地运行:
uv run uvicorn src.main:api_app --reload --port 8000码头工人
- 使用Docker Compose构建和运行:
make run配置
设置以下环境变量:
FLOAT_ACCESS_TOKEN:您的Float API访问令牌
API终点
GET /health--健康检查POST /v1/logged_time--记录时间条目GET /v1/logged_time--检索记录的时间条目
项目结构
float-mcp-server/
├── src/
│ ├── main.py
│ ├── float/
│ ├── routers/
│ └── utils/
├── docker/
│ ├── Dockerfile
│ └── docker-compose.yaml
├── Makefile
├── pyproject.toml
├── uv.lock
└── README.md许可证
MIT许可证
