mcpField
S
SpinAI App

SpinAI App

Local
github.com/KaranThink41AI & Agents0Updated 83w ago

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

  1. 01Integrate OpenAI capabilities
  2. 02Connect to HubSpot
  3. 03Express.js backend
  4. 04Configure credentials through environment variables

Use cases

  1. 01Build an application using OpenAI
  2. 02Connect HubSpot within an application
  3. 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.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

SpinAI 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

  1. Clone the repository:
git clone [your-repo-url]
cd my-spinai-app
  1. Install dependencies:
npm install
  1. Set up environment variables:
    • Copy .env.example to .env:

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-reloading
  • npm run build - Build the project for production
  • npm run start - Start the production server
  • npm run lint - Run ESLint for code formatting
  • npm run check-types - Check TypeScript types

Environment Variables

The following environment variables are required:

  • OPENAI_API_KEY - Your OpenAI API key
  • HUBSPOT_ACCESS_TOKEN - Your HubSpot access token
  • SHARED_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

Markdown supported

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.