https://github.com/fastnai/mcp-fastn
https://github.com/fastnai/mcp-fastn
Last synced: 22 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/fastnai/mcp-fastn
- Owner: fastnai
- Created: 2025-03-17T22:29:46.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-03-18T01:15:25.000Z (about 1 month ago)
- Last Synced: 2025-03-18T02:26:37.185Z (about 1 month ago)
- Language: Python
- Size: 23.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - fastn.ai – Unified API MCP Server - A unified API server enabling dynamic tool execution and integration with services like Claude.ai and Cursor.ai (Table of Contents / Other Tools and Integrations)
- awesome-mcp-servers - fastn.ai – Unified API MCP Server - A unified API server enabling dynamic tool execution and integration with services like Claude.ai and Cursor.ai (Table of Contents / Other Tools and Integrations)
README
# Fastn Server
The Fastn server is a powerful, scalable platform that enables dynamic tool registration and execution based on API definitions. It seamlessly integrates with services like Claude.ai and Cursor.ai, providing a unified server solution for a wide range of tasks. With its robust architecture, Fastn delivers exceptional performance and flexibility for real-time, API-driven operations.
## Features
- **Integrated platform support** - Use services like Slack, Notion, HubSpot, and many more through the Fastn server after completing the simple setup
- **Logging support** - Comprehensive logging system
- **Error handling** - Robust error management for various scenarios
## Step-by-Step Setup Guide
### Step 1: Fastn Setup
1. Login to your Fastn account
2. Go to "Connectors" from the left sidebar
3. Activate the service(s) you want to use by clicking on activate.
4. Go to "Settings" from the left sidebar
5. Click on "Generate API Key" and save it somewhere locally (e.g., in a notepad)
6. Click on the copy button that exists on the top bar (left side of your profile)
7. Copy your Workspace ID and save it as well
8. All setup from Fastn is now complete
### Step 2: Server Setup
## Prerequisites
- Python 3.10 or higher
## Quick Start
### macOS
```bash
# Clone repository and navigate to directory
git clone && cd fastn-server
# Install UV, create virtual environment, and install dependencies in one go
curl -LsSf https://astral.sh/uv/install.sh | sh && uv venv && source .venv/bin/activate && uv pip install -e .
# Run server (specify platform with --platform flag)
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID
```
### Windows
```bash
# Clone repository and navigate to directory
git clone && cd fastn-server
# Install UV, create a virtual environment, and install dependencies
# Option 1: Install UV using pip
python -m pip install uv
# Make sure to copy the installation path and add it to your Windows environment variables.
# Option 2: Install UV using PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex" && uv venv && .venv\Scripts\activate && uv pip install -e .
# Run server (specify platform with --platform flag)
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID
```
### Step 3: Integration with Claude On Mac OS
1. Open the Claude configuration:
```bash
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
2. Add the following configuration (replace placeholders with your actual values):
```json
{
"mcpServers": {
"fastn": {
"command": "/path/to/your/uv",
"args": [
"--directory",
"/path/to/your/fastn-server",
"run",
"fastn-server.py",
"--api_key",
"YOUR_API_KEY",
"--space_id",
"YOUR_WORKSPACE_ID"
]
}
}
}
```
### Step 4: Integration with Cursor
1. Open Cursor settings
2. Click on "MCP" in the settings menu
3. Click on "Add New"
4. Add a name for your server (e.g., "fastn")
5. Select "Command" as the type
6. Add the following command (replace placeholders with your actual values):
```
/path/to/your/uv --directory /path/to/your/fastn-server run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID
```
### Troubleshooting
#### Package Structure Error
If you encounter an error like this during installation:
```
ValueError: Unable to determine which files to ship inside the wheel using the following heuristics:
The most likely cause of this is that there is no directory that matches the name of your project (fastn).
```
**Quick Fix:**
1. Make sure `pyproject.toml` has the wheel configuration:
```toml
[tool.hatch.build.targets.wheel]
packages = ["."]
```
2. Then install dependencies:
```bash
uv pip install "httpx>=0.28.1" "mcp[cli]>=1.2.0"
```
3. Run the server:
```bash
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID
```
## Logging
Logs are output with timestamp, level, and message in the following format:
```
%(asctime)s - %(levelname)s - %(message)s
```