About SpinAI App
SpinAI App is a TypeScript application combining OpenAI capabilities with HubSpot integration. It is for developers building applications that connect AI features and HubSpot, with credentials configured through environment variables.
Key features
- 01Integrate OpenAI capabilities
- 02Connect to HubSpot
- 03Express.js backend
- 04Configure credentials through environment variables
Use cases
- 01Build an application using OpenAI
- 02Connect HubSpot within an application
- 03Configure HubSpot access credentials
MCP support
The README lists an MCP configuration file, mcp-config.ts, but does not describe what MCP capabilities the project provides.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMESpinAI App
A TypeScript-based application that integrates AI capabilities using OpenAI and other AI services.
Features
- AI-powered functionality using OpenAI
- Integration with HubSpot
- Modern TypeScript development setup
- Express.js backend
- Environment-based configuration
Prerequisites
- Node.js (v18 or higher)
- npm or yarn
- OpenAI API key
- HubSpot access token
Installation
- Clone the repository:
git clone [your-repo-url]
cd my-spinai-app
- Install dependencies:
npm install
- Set up environment variables:
- Copy
.env.exampleto.env:
- Copy
cp .env.example .env
- Edit `.env` with your credentials:
OPENAI_API_KEY="your-openai-api-key" HUBSPOT_ACCESS_TOKEN="your-hubspot-access-token" SHARED_CONTACT_ID="your-shared-contact-id"
## Development
### Running the Development Server
```bash
npm run dev
This will start the development server with hot-reloading enabled.
Building for Production
npm run build
Starting the Production Server
npm run start
Project Structure
my-spinai-app/
├── src/ # Source code
├── .env # Environment variables (copy from .env.example)
├── .env.example # Example environment variables
├── package.json # Project dependencies and scripts
├── tsconfig.json # TypeScript configuration
└── mcp-config.ts # Model Context Protocol configuration
Available Scripts
npm run dev- Start development server with hot-reloadingnpm run build- Build the project for productionnpm run start- Start the production servernpm run lint- Run ESLint for code formattingnpm run check-types- Check TypeScript types
Environment Variables
The following environment variables are required:
OPENAI_API_KEY- Your OpenAI API keyHUBSPOT_ACCESS_TOKEN- Your HubSpot access tokenSHARED_CONTACT_ID- Shared contact ID for HubSpot
Technologies Used
- TypeScript
- Node.js
- Express.js
- OpenAI SDK
- HubSpot Integration
- ESLint for code linting
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contributing
[Add contribution guidelines if applicable]
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.