Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions Dockerfile 2
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
FROM python:3.12-slim

# Set working directory
WORKDIR /app

# Copy requirements first for better caching
COPY requirements.txt .

# Install dependencies
RUN pip install --no-cache-dir -r requirements.txt

# Copy the application code
COPY biel_mcp_server.py .

# Expose the hardcoded port
EXPOSE 7832

# Health check
HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
CMD curl -f http://localhost:7832/sse || exit 1

# Run the server
CMD ["python", "biel_mcp_server.py"]
20 changes: 20 additions & 0 deletions LICENSE 2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
Copyright (c) 2025 TechDocs Studio

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
87 changes: 87 additions & 0 deletions README 2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
<div align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./logo-dark..jpg" />
<img alt="Biel.ai" src="./logo.jpg" />
</picture>
<h1>Biel.ai MCP Server</h1>
<h3>Connect your IDE to your product docs</h3>
</div>

[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/TechDocsStudio/biel-mcp)](https://archestra.ai/mcp-catalog/techdocsstudio__biel-mcp)


Give AI tools like Cursor, VS Code, and Claude Desktop access to your company's product knowledge through the [Biel.ai platform](https://biel.ai).

Biel.ai provides a hosted Retrieval-Augmented Generation (RAG) layer that makes your documentation searchable and useful to AI tools. This enables smarter completions, accurate technical answers, and context-aware suggestions—directly in your IDE or chat environment.

![Demo](./demo.png)

When AI tools can read your product documentation, they become **significantly** more helpful—generating more accurate code completions, answering technical questions with context, and guiding developers with real-time product knowledge.


> **Note:** Requires a Biel.ai account and project setup. **[Start your free 15-day trial](https://app.biel.ai/accounts/signup/)**.

<h3><a href="https://docs.biel.ai/integrations/mcp-server?utm_source=github&utm_medium=referral&utm_campaign=readme">See quickstart instructions →</a></h3>

## Getting started

### 1. Get your MCP configuration

```json
{
"mcpServers": {
"biel-ai": {
"description": "Query your product's documentation, APIs, and knowledge base.",
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.biel.ai/sse?project_slug=YOUR_PROJECT_SLUG&domain=https://your-docs-domain.com"
]
}
}
}
```

**Required:** `project_slug` and `domain`
**Optional:** `api_key` (only needed for private projects)

### 2. Add to your AI tool

* **Cursor**: **Settings** → **Tools & Integrations* → **New MCP server**.
* **Claude Desktop**: Edit `claude_desktop_config.json`
* **VS Code**: Install **MCP extension**.

### 3. Start asking questions

```
Can you check in biel_ai what the auth headers are for the /users endpoint?
```

## Self-hosting (Optional)

For advanced users who prefer to run their own MCP server instance:

### Local development
```bash
# Clone and run locally
git clone https://github.com/techdocsStudio/biel-mcp
cd biel-mcp
pip install -r requirements.txt
python biel_mcp_server.py
```

### Docker deployment
```bash
# Docker Compose (recommended)
docker-compose up -d --build

# Or Docker directly
docker build -t biel-mcp .
docker run -d -p 7832:7832 biel-mcp
```

## Support

- **Issues**: [GitHub Issues](https://github.com/techdocsStudio/biel-mcp/issues)
- **Contact**: [support@biel.ai](mailto:support@biel.ai)
- **Custom Demo**: [Book a demo](https://biel.ai/contact)
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ When AI tools can read your product documentation, they become **significantly**
<h3><a href="https://docs.biel.ai/integrations/mcp-server?utm_source=github&utm_medium=referral&utm_campaign=readme">See quickstart instructions →</a></h3>

## Getting started
[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/TechDocsStudio/biel-mcp)](https://archestra.ai/mcp-catalog/techdocsstudio__biel-mcp)

### 1. Get your MCP configuration

Expand Down
Loading