mcp-langfuse

⚠️ PROJECT SETUP STAGE - NOT READY FOR USE

This repository is currently in the initial setup phase. The project structure, tooling, and CI/CD pipelines are being configured. No functionality has been implemented yet - this is an empty shell.

Do not use this package in production or development environments.

Follow the repository for updates on when the first functional release becomes available.

MCP server for Langfuse REST API with enhanced trace analysis tools

Installation

From Source

git clone https://github.com/CrackingShells/mcp-langfuse.git
cd mcp-langfuse
pip install -e .

From PyPI (when available)

pip install mcp-langfuse

Quick Start

import mcp_langfuse

# Add basic usage example here

Development

Setup Development Environment

# Clone the repository
git clone https://github.com/CrackingShells/mcp-langfuse.git
cd mcp-langfuse

# Install in development mode
pip install -e .

# Install Node.js dependencies for semantic release
npm install

Running Tests

# Run all tests
python -m unittest discover tests

# Run specific test file
python -m unittest tests.test_basic

Code Quality Tools

Set up automated code quality checks:

# Install development dependencies
pip install -e .[dev]

# Set up pre-commit hooks
pre-commit install

# Run all checks manually
pre-commit run --all-files

Once installed, pre-commit hooks will run automatically on every git commit to ensure code quality.

Building Documentation

Build and serve documentation locally:

# Serve documentation locally with live reload
mkdocs serve

# Build documentation for production
mkdocs build

Documentation is automatically published to ReadTheDocs when changes are pushed to the repository.

Making Commits

We use Conventional Commits for automated versioning:

# Use commitizen for guided commits
npm run commit

# Or commit manually with conventional format
git commit -m "feat: add new feature"
git commit -m "fix: resolve issue with X"
git commit -m "docs: update README"

Contributing

We welcome contributions! Please see our Contributing Guide for details on:

• Development workflow
• Code style guidelines
• Testing requirements
• Pull request process

License

This project is licensed under the GNU Affero General Public License v3 - see the LICENSE file for details.

Links

• Homepage: https://github.com/CrackingShells/mcp-langfuse
• Bug Reports: https://github.com/CrackingShells/mcp-langfuse/issues
• Documentation: https://crackingshells.github.io/mcp-langfuse/