AI导哈

时间日志服务

基于FastAPI的时间日志和项目管理服务，提供与Float API集成的RESTful接口。

  • by NotHolmes
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 notholmes/float-mcp-server

使用说明

浮动MCP服务器

一个基于FastAPI的服务器，用于与Float API集成，并为时间记录和项目管理提供模型上下文协议（MCP）端点。

特性

  • 用于将时间条目记录到Float的RESTful API
  • 健康检查端点
  • Docker化，易于部署
  • 可通过环境变量进行配置

需求

  • Python 3.13+
  • 紫外线 （用于依赖关系管理）
  • Docker（用于容器化部署）

安装

  1. 克隆存储库：
    git clone https://github.com/your-org/float-mcp-server.git
cd float-mcp-server
  2. 安装依赖项：
    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许可证

相关 MCP