local logger

MCP开发工具

提供方 Pantheon-Technologies-Git

开发工具 未标注 OAuth 授权 社区 / 第三方 Cursor

一个功能优先、生产质量的本地日志系统,提供REST API写入和MCP读取接口,适用于本地开发和调试。

一句话选型结论

按资料字段整理

local logger 属于开发工具类 MCP 服务器,传输方式未标注,OAuth 授权,可直接接入 Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权OAuth 授权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

日志记录Python本地部署开发工具RESTAPIIDE集成结构化日志

安装与配置

未标注 OAuth 授权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
local logger当前 未标注 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Pantheon-Technologies-Git上游标注的维护方 Pantheon-Technologies-Git
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.0 KB
来自项目仓库与上游目录的原文,未做删改

🏠 本地日志记录器

一个以功能为先、具备生产级质量的本地日志记录系统,采用清晰的架构和双重接口。通过REST API写入日志,通过Cursor IDE中的MCP以美观的格式读取日志。

🎯 概述

Local Logger 为本地开发提供了一套完整的日志记录解决方案,包含两个相互补充的接口:

  • 📝 写入接口应用程序用于发送结构化日志的REST API
  • 📖 阅读界面用于Cursor IDE的MCP(模型上下文协议)工具,用于读取格式化日志叙述

🏗️ 建筑学

用……建造 以功能为先的模块化设计 并且 依赖注入 贯穿始终;整个过程```
local_logger/
├── integration/ # Data persistence layer (JSON files)
├── models/ # Shared Pydantic schemas
├── write_log/ # Write feature (REST API)
│ ├── endpoint/ # FastAPI endpoints
│ └── orchestrator/ # Business logic
├── read_log/ # Read feature (MCP)
│ ├── endpoint/ # MCP server
│ └── orchestrator/ # Narrative formatting
├── data/logs/ # Log file storage
├── logs/ # Server logs
└── local_logger # Server management script


### 设计原则

- **清洁架构**端点、编排器和集成层之间的清晰分离
- **依赖注入**易于测试和可替换的实现
- **特征隔离**每个功能都是独立的,并带有自己的测试
- **测试驱动开发**各层全面的测试覆盖

## 🚀 快速入门

### 1. 安装```bash
# Clone or download the project
cd local_logger

# Install dependencies (Python 3.11 required)
pip3.11 install -r requirements.txt

2. 启动服务器```bash

Start both servers (Write API + MCP)

./local_logger start

Or simply

./local_logger


### 3. 写你的第一条日志```bash
curl -X POST http://127.0.0.1:8765/log \
-H "Content-Type: application/json" \
-d '{
"trace_id": "my-session-001",
"level": "INFO",
"message": "User logged in successfully",
"timestamp": "2025-10-05T12:00:00Z",
"data": {"user_id": 123, "ip": "192.168.1.1"}
}'

4. 在Cursor中读取日志

使用MCP工具 read_logs_tool 与;和;带着 trace_id: "my-session-001" 获取;得到```
Log History for trace_id: my-session-001

  1. User logged in successfully
    - user_id: 123
    - ip: 192.168.1.1

## 📊 服务器管理

这个(或“它”) `local_logger` 该脚本提供便捷的服务器管理功能:```bash
./local_logger start    # Start both servers (kills existing first)
./local_logger stop     # Stop all servers
./local_logger restart  # Restart servers (same as start)
./local_logger status   # Check server status
./local_logger help     # Show help

服务器配置

  • 写API: http://127.0.0.1:8765 (FastAPI 附带自动重载功能)
  • 读取MCP: http://127.0.0.1:8766/sse (MCP通过HTTP)
  • 文档: http://127.0.0.1:8765/docs
  • 日志: logs/write_api.log 和 logs/mcp_server.log

📝 编写API使用方法

日志条目模式(或架构)```json

{
"trace_id": "string", // Required: Unique session/trace identifier
"level": "INFO", // Optional: DEBUG, INFO, WARN, ERROR
"message": "string", // Required: Log message
"timestamp": "2025-10-05T12:00:00Z", // Optional: ISO timestamp
"data": { // Optional: Structured metadata
"key": "value"
}
}


### 示例

**基本日志:**```bash
curl -X POST http://127.0.0.1:8765/log \
-H "Content-Type: application/json" \
-d '{"trace_id": "session-123", "message": "Process started"}'

详细日志:```bash
curl -X POST http://127.0.0.1:8765/log \
-H "Content-Type: application/json" \
-d '{
"trace_id": "debug-session",
"level": "ERROR",
"message": "Database connection failed",
"timestamp": "2025-10-05T12:30:00Z",
"data": {
"error_code": "DB_CONN_TIMEOUT",
"retry_count": 3,
"database": "users_db"
}
}'


## 📖 读取接口(MCP)

### Cursor IDE 集成

1. **配置MCP** 在里面 `~/.cursor/mcp.json`:```json
{
"mcpServers": {
"local_logger_mcp": {
"url": "http://127.0.0.1:8766/sse",
"enabled": true,
"name": "Local Logger MCP"
}
}
}
  1. 重启光标 加载MCP服务器

  2. 使用这个工具 read_logs_tool 带有参数:

  • trace_id必需的字符串
  • since可选的ISO时间戳过滤器
  • limit可选数字(默认:200)

示例输出

输入: read_logs_tool(trace_id="debug-session")

输出:```
Log History for trace_id: debug-session

  1. Process started
    - timestamp: 2025-10-05T12:00:00Z

  2. User authentication successful
    - user_id: 123
    - method: oauth
    - timestamp: 2025-10-05T12:15:00Z

  3. Database connection failed
    - error_code: DB_CONN_TIMEOUT
    - retry_count: 3
    - database: users_db
    - timestamp: 2025-10-05T12:30:00Z


## 🧪 测试

多层次的综合测试套件:```bash
# Run all tests
python3.11 -m pytest -v

# Test specific layers
python3.11 -m pytest integration/tests/ -v     # Integration layer
python3.11 -m pytest write_log/orchestrator/tests/ -v  # Write orchestrator
python3.11 -m pytest read_log/orchestrator/tests/ -v   # Read orchestrator
python3.11 -m pytest read_log/endpoint/tests/ -v       # MCP endpoint

测试理念

  • 单元测试模拟依赖项,测试业务逻辑
  • 集成测试使用临时目录进行实际文件输入/输出
  • 端到端测试通过实际的API/MCP调用进行全系统测试
  • 每个文件一个测试清晰、专注的测试组织

📁 数据存储

日志文件格式

日志以JSON数组的形式存储在 data/logs/{trace_id}.json:```json
[
{
"message": "User logged in successfully",
"timestamp": "2025-10-05T12:00:00Z",
"extras": {
"user_id": 123,
"ip": "192.168.1.1"
}
}
]


### 关键特性

- **自动分类**日志按时间戳顺序显示
- **灵活模式(或灵活架构)**: `extras` 字段接受任何结构化数据
- **人类可读**格式化打印的JSON,便于调试

## 🔧 开发

### 项目结构

- **以特性为先**每个特征(`write_log`, `read_log`是自给自足的
- **依赖注入**轻松模拟和测试
- **层分离**端点 → 调度器 → 集成 → 存储

### 添加新功能

1. 创建功能目录: `new_feature/`
1. 添加编排器: `new_feature/orchestrator/`
1. 添加终端节点: `new_feature/endpoint/`
1. 添加测试: `new_feature/*/tests/`
1. 遵循现有模式以保持一致性

### 依赖项

- **FastAPI**用于REST API的Web框架
- **FastMCP**模型上下文协议服务器
- **Pydantic(发音类似“皮丹尼克”,但中文中通常直接音译为“Pydantic”或意译为“数据验证库”,具体根据上下文决定)**数据验证和序列化
- **Uvicorn(通常指一个用于运行ASGI应用的ASGI服务器,全称为“Uvicorn ASGI Server”,在中文语境下可直接称为“Uvicorn服务器”或根据具体上下文简化为“Uvicorn”)**ASGI 服务器
- **Pytest**测试框架

## 🚨 故障排除

### 常见问题

**服务器无法启动:**```bash
./local_logger status  # Check current status
./local_logger stop    # Force stop
./local_logger start   # Clean start

端口冲突:

  • Write API使用8765端口
  • MCP服务器使用8766端口
  • 检查 local_logger 修改端口的脚本

在Cursor中MCP不工作:

  1. 验证服务器是否正在运行: ./local_logger status
  2. 检查MCP配置: ~/.cursor/mcp.json
  3. 重启 Cursor IDE
  4. 检查服务器日志: logs/mcp_server.log

导入错误:

  • 确保使用的是 Python 3.11: python3.11 --version
  • 安装依赖项: pip3.11 install -r requirements.txt

日志记录和调试

  • 服务器日志: logs/write_api.log, logs/mcp_server.log
  • 数据文件: data/logs/{trace_id}.json
  • 测试输出与……一起奔跑 -v 用于详细输出的标志

🎯 使用场景

开发调试```python

import requests

Log debug information

requests.post("http://127.0.0.1:8765/log", json={
"trace_id": "debug-session",
"message": "Variable state",
"data": {"user_count": 42, "memory_usage": "1.2GB"}
})

Read in Cursor with read_logs_tool(trace_id="debug-session")


### 应用程序监控```python
# Log application events
def log_event(trace_id, event, **data):
requests.post("http://127.0.0.1:8765/log", json={
"trace_id": trace_id,
"message": event,
"timestamp": datetime.utcnow().isoformat() + "Z",
"data": data
})

log_event("user-123", "Login successful", method="oauth", ip="192.168.1.1")
log_event("user-123", "Page viewed", page="/dashboard", load_time=1.2)

测试与持续集成/持续交付(CI/CD)```bash

Log test results

curl -X POST http://127.0.0.1:8765/log \
-d '{"trace_id": "test-run-456", "message": "Test completed",
"data": {"passed": 42, "failed": 1, "duration": "2.3s"}}'

Review in Cursor

read_logs_tool(trace_id="test-run-456")

```

📄 许可证

此项目专为本地开发使用而设计。请根据您的具体需求进行修改和扩展。


专为追求简洁、可测试日志记录及美观IDE集成的开发者打造,倾注爱心开发。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
local logger 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

local logger 怎么在 Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

local logger 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

local logger 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

local logger 支持哪些客户端?

资料标注支持 Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

local logger 能提供哪些能力?

资料显示能力标签包括 日志记录、Python、Cursor、开发工具。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。