ghostDance / README.md
nbiish
feat: implement native Gradio MCP server support
554ba9b unverified
---
title: GhostDance
emoji: ⚡️
colorFrom: purple
colorTo: indigo
sdk: gradio
sdk_version: 6.2.0
app_file: app.py
pinned: false
license: openrail
---
<div align="center">
<hr width="50%">
<h3>Support This Project</h3>
<table style="border: none; border-collapse: collapse;">
<tr style="border: none;">
<td align="center" style="border: none; vertical-align: middle; padding: 20px;">
<h4>Stripe</h4>
<img src="qr-stripe-donation.png" alt="Scan to donate" width="180"/>
<p><a href="https://raw.githubusercontent.com/nbiish/license-for-all-works/8e9b73b269add9161dc04bbdd79f818c40fca14e/qr-stripe-donation.png">Donate via Stripe</a></p>
</td>
<td align="center" style="border: none; vertical-align: middle; padding: 20px;">
<a href="https://www.buymeacoffee.com/nbiish">
<img src="buy-me-a-coffee.svg" alt="Buy me a coffee" />
</a>
</td>
</tr>
</table>
<hr width="50%">
</div>
# GhostDance
Ghost Dance protocol
## Citation
```bibtex
@misc{ghostDance2025,
author/creator/steward = {ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band and enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians},
title/description = {ghostDance},
type_of_work = {Indigenous digital creation/software incorporating traditional knowledge and cultural expressions},
year = {2025},
publisher/source/event = {GitHub repository under tribal sovereignty protections},
howpublished = {\url{https://github.com/nbiish/ghostDance}},
note = {Authored and stewarded by ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band and enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians. This work embodies Indigenous intellectual property, traditional knowledge systems (TK), traditional cultural expressions (TCEs), and associated data protected under tribal law, federal Indian law, treaty rights, Indigenous Data Sovereignty principles, and international indigenous rights frameworks including UNDRIP. All usage, benefit-sharing, and data governance are governed by the COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS.}
}
```
## Copyright
Copyright © 2025 ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), a descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band, and an enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians. This work embodies Traditional Knowledge and Traditional Cultural Expressions. All rights reserved.
## MCP Server (AI Integration)
GhostDance supports the Model Context Protocol (MCP). This allows AI tools like Cursor, Claude Desktop, or Cline to use the Ghost Dance calculation directly as a tool.
### How to use in Cursor:
1. **Install Dependencies**: Ensure you have `gradio[mcp]` installed:
```bash
pip install "gradio[mcp]"
```
2. **Run the App**: Start the GhostDance application:
```bash
python app.py
```
The app will start the web UI and the MCP server. Look for the MCP SSE URL in the console (usually `http://127.0.0.1:7860/gradio_api/mcp/sse`).
3. **Configure Cursor**:
* Open Cursor Settings.
* Navigate to **Features** -> **MCP**.
* Click **+ Add New MCP Server**.
* **Name**: `GhostDance`
* **Type**: `sse`
* **URL**: `http://127.0.0.1:7860/gradio_api/mcp/sse`
Once configured, you can ask Cursor to "Calculate Ghost Dance stride for a weight of 180 lbs" and it will use the tool automatically.